Table of Contents

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 referenced 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 otherwise:

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 calling imta_error() immediately afterwards.

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

_______________________________________
9 |9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9 777777777777777777779 |9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9 777777777777777777779 |9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9|9 7777777777777777777SEE ALSO imme_init(3) , immd_write_header(3)

SunOS 5.5.1 Last change: 05 Jan 1998 2


Table of Contents