Begin the message header of a message which is being enqueued.

PASCAL

status = PMDF_start_message_header (nq_context)

C

status = PMDFstartMessageHeader (nq_context)

int PMDFstartMessageHeader(PMDF_nq **nq_context)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope.

Description

After the message envelope has been constructed by calls to PMDFaddRecipient, the construction of the message header is started with a call to PMDFstartMessageHeader. Header lines can be written with PMDFwriteHeader, PMDFwriteLine, PMDFwriteText, PMDFwriteFrom, PMDFwriteDate, and PMDFwriteSubject. The only mandatory header lines which must be written are the "From:" and "Date:" header lines. PMDF will supply all other required header lines.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__BADCONTEXT	Illegal or corrupt context. Message header not started.