tibrvMsg_CreateFromBytes()
Function
Declaration
tibrv_statustibrvMsg_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 |
|
|
The program supplies a location for the new message. The function creates a new message and stores a pointer to it in that location. |
|
|
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(). |