NAME
imme_write_header - Write a message header to a message
being enqueued.
SYNOPSIS
#include <imta.h>
int imme_write_header(imme_t me, imhdr_t hdr);
DESCRIPTION
imme_write_header() writes the message header object refer-
enced by hdr to a message being enqueued with the enqueue
context referenced by me.
The header object hdr may be created with the message header
API, e.g. imhdr_add_line(), or it may be read from a mes-
sage being dequeued by calling immd_read_header().
RETURN VALUES
imme_write_header() returns IMRC_OK when successful, and a
negative error code otherwise.
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_ENVELOPE
The message envelope has not been created. Call
imme_start_envelope() to create it.
IMRC_NO_RECIPIENT
adr is nil.
In particular, imme_write_header() will fail if called
before any recipient of the message have been specified. 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 | | |
imta-test-rewrite(1), imme_init(3), immd_read_header(3),
imme_add_headerLine(3) | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |