NAME
imme_write_text - Write text to a message being enqueued.
SYNOPSIS
#include <imta.h>
int imme_write_text(imme_t me, const char *text);
DESCRIPTION
imme_write_text() writes the NULL-terminated string refer-
enced text in the body of a message being enqueued
corresponding to the enqueue context me . It must be called
only after has been called.
imme_write_text() does not append line a terminator (CRLF
for SMTP) to the given string, text. It is left to caller
to include line terminators, where appropriate, in their
text. This allows a single call to output multiple lines of
text to the message body. If this terminator is omitted
then, in the message being composed, the subsequent line
will be appended directly to the end the given text lacking
a terminator.
RETURN VALUES
imme_write_text() returns IMRC_OK when successful. And oth-
erwise:
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_ENVELOPE
The message envelope has not been created. Call
imme_start_envelope() to create it.
A textual explanation of the failure can be obtained by cal-
ling imta_error() immediately afterwards.
ATTRIBUTES
_______________________________________
| Attribute Type | Attribute Value|
|____________________|_________________|
| Architecture | sparc, x86 |
|____________________|_________________|
| Availability | SUNWimsdk |
|____________________|_________________|
| MT-Level | MT-Safe |
|____________________|_________________|
| Interface Stability| Stable |
|____________________|_________________|
SEE ALSO
imme_init(3), immd_write_header(3)