TibrvMsg::getAsBytesCopy()

Method

Declaration

TibrvStatus getAsBytesCopy(
    void* bytePtr,
    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 method 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
bytePtr	The program supplies a byte buffer. The method copies the byte sequence into that buffer.
byteSize	The size of the buffer.

See Also

TibrvMsg::getAsBytes()

TibrvMsg::getByteSize()

TibrvMsg()