tibrvMsg_CreateFromBytes()

Function

Declaration

tibrv_status tibrvMsg_CreateFromBytes(
    tibrvMsg*           message,
    const void*         bytes);

Purpose

Create a new message, and populate it with data.

Remarks

This function allocates storage for the new message. The program owns the message, and must destroy it to reclaim the storage. That is, each call to this function must be paired with a call to tibrvMsg_Destroy().

This function copies the bytes into the new message.

Programs can add address information to the message using tibrvMsg_SetSendSubject(), and tibrvMsg_ConvertToString().

Parameter

Description

message

The program supplies a location for the new message. The function creates a new message and stores a pointer to it in that location.

bytes

Fill the new message with this data. This data buffer represents the message in Rendezvous wire format, as produced by tibrvMsg_GetAsBytes() or tibrvMsg_GetAsBytesCopy().

See Also

tibrvMsg_GetAsBytes()

tibrvMsg_GetAsBytesCopy()