Set the NOTARY flags for the next envelope recipient address.

PASCAL

status = PMDF_set_recipient_flags

(nq_context, notary_flags)

C

status = PMDFsetRecipientFlags

(nq_context, notary_flags)

int PMDFsetRecipientFlags(PMDF_nq **dq_context, int notary_flags)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope.

notary_flags

Longword integer containing NOTARY flag bits.

Description

PMDF mail messages carry per recipient NOTARY information in their envelope. This information is aligned with the NOTARY SMTP extension as described in RFC 1891 and describes failure and success handling requested by the sender (e.g., send a delivery receipt, send failure notifications but do not include return of content, never send any form of notifications, etc.). By default, when an envelope recipient address is enqueued, PMDF assigns it the NOTARY handling PMDF_RECEIPT_FAILURES + PMDF_RECEIPT_DELAYS which indicates that non-delivery notifications (NDNs) should be generated for delivery failures and delays. To select, for a given envelope recipient address, different handling characteristics or to propogate NOTARY flags from a previous dequeue operation, call PMDFsetRecipientFlags prior to calling PMDFaddRecipient. The notary_flags argument is a bit mask whose bits are given in Table 1-6. Note that PMDF_RECEIPT_NEVER and PMDF_RECEIPT_FAILURES can not both be set. If both are set, then PMDF_RECEIPT_NEVER will be ignored. Similarly, if both PMDF_RECEIPT_HEADER and PMDF_RECEIPT_NOHEADER are set, then PMDF_RECEIPT_NOHEADER is ignored. When neither are set, then notifications will include full return of content (RET=FULL).

Return Values

PMDF__OK	Normal, successful completion.
PMDF__BADCONTEXT	Illegal or corrupt context. No flags set.