ReceiptIn Event

Fires when the class receives a receipt from the server.

Syntax

ANSI (Cross Platform)
virtual int FireReceiptIn(STOMPReceiptInEventParams *e);
typedef struct {
const char *ReceiptId; int reserved; } STOMPReceiptInEventParams; Unicode (Windows) virtual INT FireReceiptIn(STOMPReceiptInEventParams *e);
typedef struct {
LPCWSTR ReceiptId; INT reserved; } STOMPReceiptInEventParams;
- (void)onReceiptIn:(NSString*)receiptId;
#define EID_STOMP_RECEIPTIN 9

virtual INT IPWORKSMQ_CALL FireReceiptIn(LPSTR &lpszReceiptId);

Remarks

This event fires anytime the class receives a receipt (that is, a confirmation that the server has received one or more frames) from the server. The ReceiptId parameter reflects the value of the receipt-id header in the incoming RECEIPT frame.

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):

  1. SEND-3
  2. SEND-4
  3. SEND-5
  4. SEND-6
then the server could, at some point, send back a single receipt with a receipt-id header value of SEND-5 to confirm that it has received the first three frames.

Refer to RequestReceipts for more information about receipts.

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks MQ 2020 C++ Edition - Version 20.0 [Build 8155]