PMDF Programmer's Reference Manual
Previous Next Contents Index

PMDFsetReceiptAddresses

Specify delivery and read receipt request addresses for a message being enqueued.

PASCAL

status = PMDF_set_receipt_addresses

(nq_context, read_address, delivery_address)

argument information
Argument Data type Access Mechanism
nq_context context pointer read/write reference
read_address descriptor read reference
delivery_address descriptor read reference

C

status = PMDFsetReceiptAddresses

(nq_context, read_address, read_address_len, delivery_address, delivery_address_len)

argument information 


int PMDFsetReceiptAddresses(PMDF_nq **nq_context, 
                            char     *read_address, 
                            int       read_address_len, 
                            char     *delivery_address, 
                            int       delivery_address_len)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope.

read_address

Address to send a read receipt to. Length can not exceed ALFA_SIZE bytes.

read_address_len

Length in bytes of read_address.

delivery_address

Address to send a delivery receipt to. Length can not exceed ALFA_SIZE bytes.

delivery_address_len

Length in bytes of delivery_address.

Description

PMDFsetReceiptAddresses can 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 PMDFreceiptControl call 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 PMDFsetReceiptAddresses.

Return Values

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.

Previous Next Contents Index