Specify delivery and read receipt request addresses for a message being enqueued.
status = PMDF_set_receipt_addresses
(nq_context, read_address, delivery_address)
status = PMDFsetReceiptAddresses
(nq_context, read_address, read_address_len, delivery_address, delivery_address_len)
int PMDFsetReceiptAddresses(PMDF_nq **nq_context, char *read_address, int read_address_len, char *delivery_address, int delivery_address_len)
nq_contextA message enqueue context created with
read_addressAddress to send a read receipt to. Length can not exceed
read_address_lenLength in bytes of read_address.
delivery_addressAddress to send a delivery receipt to. Length can not exceed
delivery_address_lenLength in bytes of delivery_address.
PMDFsetReceiptAddressescan be called to set default values for the addresses to which to send read or delivery receipts. If either string has zero length, then no default will be set for the associated receipt address. These addresses will then be used in the construction of read or delivery receipt request header lines whenever a read or delivery receipt is requested for the specified message enqueue context. Note that these default addresses can be overridden by other receipt request mechanisms or suppressed in response to
PMDFreceiptControlcall with suppress_receipts set true. By default, no read or delivery receipt addresses are set. Settings made with this routine only affect the specified message enqueue context and can be further changed by additional calls to
PMDF__OK Normal, successful completion. PMDF__BADCONTEXT Illegal or corrupt context. Receipt addresses not changed. PMDF__INVSTRDES Invalid string descriptor for read_address or delivery_address: one or both of the descriptors has an invalid value in its DSC$B_CLASS field. Receipt addresses not changed. PMDF__STRTRUERR One or both of the input strings exceeds ALFA_SIZE bytes. Receipt addresses not changed.