RequestReceipts Property
Whether the class should request that the server provide message receipts.
Syntax
bool GetRequestReceipts();
int SetRequestReceipts(bool bRequestReceipts);
Default Value
false
Remarks
This property is used to specify whether the class should request that the server send back confirmations (known as a "receipts" in STOMP terminology) when it receives messages from the class. This is done by adding a receipt header to the outgoing frame.
When this property is set to True, and a message is sent, the ReceiptOut event will fire immediately after the MessageOut event fires.
Note that, while this property only controls receipt requests for outgoing messages, the class is capable of requesting receipts for any outgoing frame type. Use this table to determine which API members control receipt request for each outgoing frame type (all are False by default):
To Request Receipts For... | Set The... |
Messages | RequestReceipts property |
Message acknowledgment frames | RequestAckReceipts configuration setting |
Subscribe and Unsubscribe frames | RequestSubscriptionReceipts configuration setting |
Begin, Commit, and Abort transaction frames | RequestTransactionReceipts configuration setting |
Received Receipt Notes
When a receipt is received, the ReceiptIn event fires.
Note that receipts are cumulative, and a STOMP server is not required to send back discrete receipts for each frame it receives that has a receipt header. For example, if the class has sent four message frames with the following receipt header values (in chronological order):
- SEND-3
- SEND-4
- SEND-5
- SEND-6
This property is not available at design time.
Data Type
Boolean