Set the NOTARY flags for the next envelope recipient address.
status = PMDF_set_recipient_flags
status = PMDFsetRecipientFlags
int PMDFsetRecipientFlags(PMDF_nq **dq_context, int notary_flags)
nq_contextA message enqueue context created with
notary_flagsLongword integer containing NOTARY flag bits.
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
PMDFsetRecipientFlagsprior 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).
PMDF__OK Normal, successful completion. PMDF__BADCONTEXT Illegal or corrupt context. No flags set.