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

PASCAL

status = PMDF_start_message_header (nq_context)

argument information

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

C

status = PMDFstartMessageHeader (nq_context)

argument information

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.