RTI Connext C API Version 7.1.0
DDS_TransportMulticastMappingFunction_t Struct Reference

Type representing an external mapping function. More...

Data Fields

char * dll
 Specifies a dynamic library that contains a mapping function. More...
 
char * function_name
 Specifies the name of a mapping function. More...
 

Detailed Description

Type representing an external mapping function.

A mapping function is defined by a dynamic library name and a function name.

QoS:
DDS_TransportMulticastMappingQosPolicy

Field Documentation

◆ dll

char* DDS_TransportMulticastMappingFunction_t::dll

Specifies a dynamic library that contains a mapping function.

A relative or absolute path can be specified.

If the name is specified as "foo", the library name on Linux systems will be libfoo.so; on Windows systems it will be foo.dll.

[default] NULL

◆ function_name

char* DDS_TransportMulticastMappingFunction_t::function_name

Specifies the name of a mapping function.

This function must be implemented in the library specified in DDS_TransportMulticastMappingFunction_t::dll.

The function must implement the following interface:

int function(const char* topic_name, int numberOfAddresses);

The function must return an integer that indicates the index of the address to use for the given topic_name. For example, if the first address in the list should be used, it must return 0; if the second address in the list should be used, it must return 1, etc.