PMDF Programmer's Reference Manual
Previous Next Contents Index

PMDFwriteFrom

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.

Previous Next Contents Index