Click or drag to resize

DomainParticipantIgnoreParticipant Method

Instructs DDS to locally ignore a remote DomainParticipant. From that point onwards the local DomainParticipant will behave as if the remote DomainParticipant did not exist. This means it will ignore any topic, publication, or subscription that originates on that DomainParticipant.

Namespace:  OpenDDSharp.DDS
Assembly:  OpenDDSharp (in OpenDDSharp.dll) Version: 0.5.0.0
Syntax
Copy
public ReturnCode IgnoreParticipant(
	InstanceHandle handle
)

Parameters

handle
Type: OpenDDSharp.DDSInstanceHandle
The InstanceHandle of the DomainParticipant to be ignored.

Return Value

Type: ReturnCode
The ReturnCode that indicates the operation result.
Remarks

This operation can be used, in conjunction with the discovery of remote participants offered by means of the “DCPSParticipant” built-in Topic, to provide, for example, access control. Application data can be associated with a DomainParticipant by means of the UserDataQosPolicy.This application data is propagated as a field in the built-in topic and can be used by an application to implement its own access control policy.

The DomainParticipant to ignore is identified by the handle argument. This handle is the one that appears in the SampleInfo retrieved when reading the data-samples available for the built-in DataReader to the “DCPSParticipant” topic. The built-in DataReader is read with the same read/take operations used for any DataReader.

There is no way to reverse this operation.

See Also