DDS_TransportUnicastSettings_t Struct Reference
[Unicast Settings]

Type representing a list of unicast locators. More...

List of all members.

Public Attributes

struct DDS_StringSeq transports
 A sequence of transport aliases that specifies the unicast interfaces on which to receive unicast traffic for the entity.
DDS_Long receive_port
 The unicast port on which the entity can receive data.


Detailed Description

Type representing a list of unicast locators.

A unicast locator specifies a transport class, a unicast address, and a unicast port number on which messages can be received by an entity.

QoS:
DDS_TransportUnicastQosPolicy

Member Data Documentation

A sequence of transport aliases that specifies the unicast interfaces on which to receive unicast traffic for the entity.

Of the transport instances available to the entity, only those with aliases matching an alias on this sequence are used to determine the unicast interfaces used by the entity.

Thus, this list of aliases sub-selects from the transports available to the entity.

Each unicast interface on a transport results in a unicast locator for the entity.

An empty sequence is a special value that specifies all the transports available to the entity.

The memory for the strings in this sequence is managed according to the conventions described in Conventions. In particular, be careful to avoid a situation in which RTI Data Distribution Service allocates a string on your behalf and you then reuse that string in such a way that RTI Data Distribution Service believes it to have more memory allocated to it than it actually does.

Alias names for the builtin transports are defined in TRANSPORT_BUILTIN.

[default] Empty sequence; i.e. all the transports available to the entity.
[range] Any sequence of non-null, non-empty strings.

The unicast port on which the entity can receive data.

Must be an unused unicast port on the system.

[default] 0, which implies that the actual port number is determined by a formula as a function of the domain_id, and the DDS_WireProtocolQosPolicy::participant_id.

[range] [0,0xffffffff]

See also:
DDS_WireProtocolQosPolicy::participant_id.


RTI Data Distribution Service C++ API Version 4.5e Copyright © 23 Oct 2011 Real-Time Innovations, Inc