Write a "From:" header line to a message being enqueued.

PASCAL

status = PMDF_write_from (nq_context, from)

argument information

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

C

status = PMDFwriteFrom

(nq_context, from, from_len)

argument information

int PMDFwriteFrom(PMDF_nq **nq_context, char *from, int from_len)

Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope .

from

Envelope "From:" address for the message to be enqueued. Length can not exceed ALFA_SIZE bytes.

from_len

Length in bytes of the envelope "From:" address.

Description

PMDFwriteFrom will output a "From:" header line to a message header. The address cited in the header line will be that supplied with the from argument. PMDFwriteFrom should be called after PMDFstartMessageHeader and prior to calling PMDFstartMessageBody . If it is called after PMDFstartMessageBody , then it's output will become part of the message body.

Return Values

PMDF__OK	Normal, successful completion.
PMDF__BADCONTEXT	Illegal or corrupt context. "Date:" header line not written.
PMDF__INVSTRDES	Invalid string descriptor for from: descriptor has an invalid value in its DSC$B_CLASS field. Header line not written.
PMDF__STRTRUERR	The from input string is too long. Header line not written.