DDS12 — Improper prototype for get_XXX_status()

Summary:
In the PIM, all get_XXX_status() methods return the relevant status by value. This does not allow for an error return and is inconsistent with other operations that accept a parameter.
The same is true for the PSM except for get_inconsistent_topic_status() on the Topic which returns ReturnCode_t and the status is a parameter.

Proposed Resolution:
In the PIM and the PSM, the operations should return ReturnCode_t with the status as a parameter.

Proposed Revised Text:

Section 2.1.2.3.2 Topic Class; Replace
get_inconsistent_topic_status InconsistentTopicStatus
With
get_inconsistent_topic_status ReturnCode_t
inout: status InconsistentTopicStatus
Section 2.1.2.4.2 DataWriter Class;
Replace
get_liveliness_lost_status LivelinessLostStatus
get_offered_deadline_missed_status OfferedDeadlineMissedStatus
get_offered_incompatible_qos_status OfferedIncompatibleQosStatus
get_publication_match_status PublicationMatchedStatus
With
get_liveliness_lost_status ReturnCode_t
inout: status LivelinessLostStatus
get_offered_deadline_missed_status ReturnCode_t
inout: status OfferedDeadlineMissedStatus
get_offered_incompatible_qos_status ReturnCode_t
inout: status OfferedIncompatibleQosStatus
get_publication_match_status ReturnCode_t
inout: status PublicationMatchedStatus
Section 2.1.2.5.2 Subscriber Class;
Replace
get_sample_lost_status SampleLostStatus
With
get_sample_lost_status ReturnCode_t
inout: status SampleLostStatus
Section 2.1.2.5.3 DataReader Class;
Replace
get_liveliness_changed_status LivelinessChangedStatus
get_requested_deadline_missed_status RequestedDeadlineMissedStatus
get_requested_incompatible_qos_status RequestedIncompatibleQosStatus
get_sample_rejected_status SampleRejectedStatus
get_subscription_match_status SubscriptionMatchedStatus
With
get_liveliness_changed_status ReturnCode_t
inout: status LivelinessChangedStatus
get_requested_deadline_missed_status ReturnCode_t
inout: status RequestedDeadlineMissedStatus
get_requested_incompatible_qos_status ReturnCode_t
inout: status RequestedIncompatibleQosStatus
get_sample_rejected_status ReturnCode_t
inout: status SampleRejectedStatus
get_subscription_match_status ReturnCode_t
inout: status SubscriptionMatchedStatus
Section 2.2.3 DCPS PSM : IDL

interface DataWriter; Replace:
LivelinessLostStatus get_liveliness_lost_status();
OfferedDeadlineMissedStatus get_offered_deadline_missed_status();
OfferedIncompatibleQosStatus get_offered_incompatible_qos_status();
PublicationMatchedStatus get_publication_match_status();
With
ReturnCode_t get_liveliness_lost_status(inout LivelinessLostStatus status);
ReturnCode_t get_offered_deadline_missed_status(inout OfferedDeadlineMissedStatus status);
ReturnCode_t get_offered_incompatible_qos_status(inout OfferedIncompatibleQosStatus status);
ReturnCode_t get_publication_match_status(inout PublicationMatchedStatus status);

interface DataReader; Replace:
SampleRejectedStatus get_sample_rejected_status();
LivelinessChangedStatus get_liveliness_changed_status();
RequestedDeadlineMissedStatus get_requested_deadline_missed_status();
RequestedIncompatibleQosStatus get_requested_incompatible_qos_status();
SubscriptionMatchedStatus get_subscription_match_status();
SampleLostStatus get_sample_lost_status();
With:
ReturnCode_t get_sample_rejected_status( inout SampleRejectedStatus status );
ReturnCode_t get_liveliness_changed_status(inout LivelinessChangedStatus status);
ReturnCode_t get_requested_deadline_missed_status(inout RequestedDeadlineMissedStatus status);
ReturnCode_t get_requested_incompatible_qos_status(inout RequestedIncompatibleQosStatus status);
ReturnCode_t get_subscription_match_status(inout SubscriptionMatchedStatus status);
ReturnCode_t get_sample_lost_status(inout SampleLostStatus status);

see above