Table of Contents

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 parameter 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. Otherwise, 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 _______________________________________ |
|
|

SunOS 5.5.1 Last change: 05 Jan 1998 1

imme_start_envelope(3) C Library Functions imme_start_envelope(3)

See Also

imme_init(3) , imta_error(3) , imme_add_recipient(3) , immd_read_text(3)

SunOS 5.5.1 Last change: 05 Jan 1998 2

Table of Contents