Function dds_get_matched_publication_data

• Defined in File dds.h

Function Documentation

dds_builtintopic_endpoint_t *dds_get_matched_publication_data(dds_entity_t reader, dds_instance_handle_t ih)

Get a description of a writer matched with the provided reader.

This operation looks up the writer instance handle in the set of writers matched with the specified reader, returning a freshly allocated sample of the DCPSPublication built-in topic if found, and NULL if not. The caller is responsible for freeing the memory allocated, e.g. using dds_builtintopic_free_endpoint.

This operation is similar to performing a read of the given instance handle on a reader of the DCPSPublication built-in topic, but this operation additionally filters on whether the writer is matched by the provided reader.

Parameters

• reader – [in] The reader.

• ih – [in] The instance handle of a writer.

Return values

• != – NULL The requested data

• NULL – The reader is not valid or ih is not an instance handle of a matched writer.

Returns

A newly allocated sample containing the information on the writer, or a NULL pointer for any kind of failure.