Function dds_create_domain_with_rawconfig

Function Documentation

dds_entity_t dds_create_domain_with_rawconfig(const dds_domainid_t domain, const struct ddsi_config *config)

Creates a domain with a given configuration, specified as an initializer (unstable interface)

To explicitly create a domain based on a configuration passed as a raw initializer rather than as an XML string. This allows bypassing the XML parsing, but tightly couples the initializing to implementation. See dds/ddsi/ddsi_config.h:ddsi_config_init_default for a way to initialize the default configuration.

It will not be created if a domain with the given domain id already exists. This could have been created implicitly by a dds_create_participant().

Please be aware that the given domain_id always takes precedence over the configuration.

Parameters

  • domain – [in] The domain to be created. DEFAULT_DOMAIN is not allowed.

  • config – [in] A configuration initializer. The lifetime of any pointers in config must be at least that of the lifetime of the domain.

Return values

  • DDS_RETCODE_BAD_PARAMETER – Illegal value for domain id or the config parameter is NULL.

  • DDS_RETCODE_PRECONDITION_NOT_MET – The domain already existed and cannot be created again.

  • DDS_RETCODE_ERROR – An internal error has occurred.

Returns

A valid entity handle or an error code.