Table of Contents

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

Attributes

_______________________________________

Attribute Type
Attribute Value _______________________________________
Architecture
sparc, x86 _______________________________________
Availability
SUNWimsdk _______________________________________
MT-Level
MT-Safe
_______________________________________
Interface Stability
Stable _______________________________________ 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 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 7777777777777777777SEE ALSO imta-test-rewrite(1) , imme_init(3) , immd_read_header(3) , imme_add_headerLine(3)

Table of Contents