9.2.4 Looking Up DomainParticipants

The DomainParticipantFactory has these useful operations for retrieving its DomainParticipants:

• get_participants() returns a sequence of pointers to all the DomainParticipants within the DomainParticipantFactory.

DDS_ReturnCode_t 
	get_participants (DDSDomainParticipantSeq & participants)

• lookup_participant() locates an existing DomainParticipant based on its domain ID.

DDSDomainParticipant * 
	lookup_participant (DDS_DomainId_t domainId)

• lookup_participant_by_name () locates an existing DomainParticipant based on its name.

DDSDomainParticipant * 
	lookup_participant_by_name(const char * participant_name)

Note: in the Modern C++ API these operations are freestanding functions rti::domain::find_participants(), dds::domain::find(), and rti::domain::find_participant_by_name(), respectively.

© 2020 RTI