tibrvMsg_GetAsBytes()

Function

Declaration

tibrv_status tibrvMsg_GetAsBytes(
    tibrvMsg          message,
    const void**      bytePtr);

Purpose

Extract the data from a message as a byte sequence.

Remarks

Return the data as a byte sequence, suitable for archiving in a file.

The storage for the byte sequence is associated with the message, and persists until the message is destroyed. Programs must not modify the resulting byte sequence, which remains part of the message object. To make a copy that your program can modify, use tibrvMsg_GetAsBytesCopy().

The byte data includes the message header and all message fields in Rendezvous wire format. It does not include address information, such as the subject and reply subject, nor certified delivery information.

The byte sequence can contain interior NULL bytes.

Parameter	Description
message	Extract the data bytes from this message.
bytePtr	The program supplies a location. The function stores a pointer to the byte sequence in that location.

See Also

tibrvMsg_GetAsBytesCopy()

tibrvMsg_GetByteSize()

tibrvMsg_CreateFromBytes()