NAME
imme_start_envelope - Begins the enqueue of one message.
SYNOPSIS
#include <imta.h>
int imme_start_envelope(imme_t me, const char *from);
DESCRIPTION
imme_start_envelope() must be called to start a message
enqueue. Nothing can be written to a message being
enqueued, prior to calling imme_start_envelope(). The from
argument specifies the envelope From: address to associate
with the message being enqueued. It is a mandatory parame-
ter and it should conform to RFC 822. After calling
imme_start_envelope(), imme_add_recipient() should be called
to specify all message recipients (To:, Cc:, and Bcc:
addresses).
RETURN VALUES
imme_start_envelope() returns IMRC_OK when successful. Oth-
erwise, one of the following error codes is returned:
IMRC_BAD_CONTEXT
The enqueue context me has not been initialized
or has been corrupted. Make sure imme_init()
has been previously called.
IMRC_NO_MAILFROM
from is null. Cannot create an envelope without
an originator. Envelope not started.
IMRC_INVALID_ADDRESS
from is a non-rfc822-compliant address.
Envelope not started
ATTRIBUTES
_______________________________________
| Attribute Type | Attribute Value|
|____________________|_________________|
| Architecture | sparc, x86 |
|____________________|_________________|
| Availability | SUNWimsdk |
|____________________|_________________|
| MT-Level | MT-Safe |
|____________________|_________________|
| Interface Stability| Stable |
|____________________|_________________|
SEE ALSO
imme_init(3), imta_error(3), imme_add_recipient(3),
immd_read_text(3)