RTI Connext Modern C++ API Version 7.2.0
rti::core::status::ServiceRequestAcceptedStatus Class Reference

<<extension>> Information about the status dds::core::status::StatusMask::service_request_accepted() More...

#include <Status.hpp>

Inherits rti::core::NativeValueType< T, NATIVE_T, ADAPTER >.

Public Member Functions

EventCount32 total_count () const
 The total cumulative number of ServiceRequests that have been accepted by a dds::pub::DataWriter. More...
 
EventCount32 current_count () const
 The current number of ServiceRequests that have been accepted by this dds::pub::DataWriter. More...
 
dds::core::InstanceHandle last_request_handle () const
 A handle to the last rti::topic::ServiceRequest that caused the dds::pub::DataWriter's status to change. More...
 
rti::core::ServiceRequestId service_id () const
 ID of the service to which the accepted Request belongs. More...
 

Detailed Description

<<extension>> Information about the status dds::core::status::StatusMask::service_request_accepted()

Currently, the only service that causes the ServiceRequestAcceptedStatus to be triggered is the rti::sub::TopicQuery service. A rti::topic::ServiceRequest is accepted when a dds::pub::DataWriter matches with a dds::sub::DataReader that has created a rti::sub::TopicQuery.

This status is also changed (and the listener, if any, called) when a ServiceRequest has been cancelled, or deleted. This will happen when a dds::sub::DataReader deletes a TopicQuery using rti::sub::TopicQuery::close().

Member Function Documentation

◆ total_count()

EventCount32 rti::core::status::ServiceRequestAcceptedStatus::total_count ( ) const
inline

The total cumulative number of ServiceRequests that have been accepted by a dds::pub::DataWriter.

This number increases whenever a new request is accepted. It does not change when a request is cancelled.

◆ current_count()

EventCount32 rti::core::status::ServiceRequestAcceptedStatus::current_count ( ) const
inline

The current number of ServiceRequests that have been accepted by this dds::pub::DataWriter.

This number increases when a new request is accepted and decreases when an existing request is cancelled.

◆ last_request_handle()

dds::core::InstanceHandle rti::core::status::ServiceRequestAcceptedStatus::last_request_handle ( ) const
inline

A handle to the last rti::topic::ServiceRequest that caused the dds::pub::DataWriter's status to change.

◆ service_id()

rti::core::ServiceRequestId rti::core::status::ServiceRequestAcceptedStatus::service_id ( ) const
inline

ID of the service to which the accepted Request belongs.

See also
rti::core::ServiceRequestId_def::TOPIC_QUERY