tibrvMsg_GetAsBytesCopy()

Function

Declaration

tibrv_status tibrvMsg_GetAsBytesCopy(
    tibrvMsg          message,
    void*             buf,
    tibrv_u32         byteSize);

Purpose

Extract a copy of the data from a message as a byte sequence.

Remarks

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

This function copies the message data into a buffer, which the program owns and may modify.

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.

To allocate appropriate storage, programs determine the length of the byte sequence using tibrvMsg_GetByteSize().

The byte sequence can contain interior NULL bytes.

Parameter	Description
message	Extract the data from this message.
buf	The program supplies a buffer. The function copies the byte sequence into that buffer.
byteSize	The size of the buffer.

See Also

tibrvMsg_GetAsBytes()

tibrvMsg_GetByteSize()

tibrvMsg_CreateFromBytes()