Make a verbatim copy of a message header and content.

PASCAL

status = PMDF_copy_message

(dq_context, nq_context)

argument information

Argument	Data type	Access	Mechanism
dq_context	context pointer	read/write	reference
nq_context	context pointer	read/write	reference

C

status = PMDFcopyMessage

(dq_context, nq_context)

argument information

int PMDFcopyMessage(PMDF_dq **dq_context, PMDF_nq **nq_context)

Arguments

dq_context

A message dequeue context created with PMDFdequeueInitialize .

nq_context

A message enqueue context created with PMDFstartMessageEnvelope .

Description

Use PMDFcopyMessage to efficiently copy to a new message being enqueued a verbatim copy of a message being dequeued. Only the portion of the dequeued message following the read point for that message will be copied. Thus, if the entire dequeued message --- header and content --- is to be copied, then it can be necessary to first call PMDFrewindMessage . PMDFcopyMessage is especially useful in cases where a message needs to have it's envelope changed but be left enqueued. For example, when a message was successfully delivered to some but not all recipients. In that case, if some of the recipients could not be delivered to owing to temporary problems, the message should be re-enqueued verbatim to just those recipients who could not be handled because of temporary problems. In such a case, be sure to also call PMDFaliasNoExpansion while enqueuing the new message.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__BADCONTEXT	Bad value passed for dq_context or nq_context.