Function dds_wait_for_acks

Function Documentation

dds_return_t dds_wait_for_acks(dds_entity_t publisher_or_writer, dds_duration_t timeout)

Waits at most for the duration timeout for acks for data in the publisher or writer.

This operation blocks the calling thread until either all data written by the publisher or writer is acknowledged by all matched reliable reader entities, or else the duration specified by the timeout parameter elapses, whichever happens first.

Parameters

  • publisher_or_writer – [in] Publisher or writer whose acknowledgments must be waited for

  • timeout – [in] How long to wait for acknowledgments before time out

Return values

  • DDS_RETCODE_OK – All acknowledgments successfully received with the timeout.

  • DDS_RETCODE_BAD_PARAMETER – The publisher_or_writer is not a valid publisher or writer.

  • DDS_RETCODE_TIMEOUT – Timeout expired before all acknowledgments from reliable reader entities were received.

  • DDS_RETCODE_UNSUPPORTED – Operation is not supported.

Returns

A dds_return_t indicating success or failure.