Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Messages : tibemsMsg : tibemsMsg_CreateFromBytes

tibemsMsg_CreateFromBytes
Function
Purpose
Create a message object from data in a byte sequence.
C Declaration
tibems_status tibemsMsg_CreateFromBytes(
    tibemsMsg* message,
    const void* bytes );
COBOL Call
CALL "tibemsMsg_CreateFromBytes"
USING BY REFERENCE message,
BY REFERENCE bytes,
RETURNING tibems-status
END-CALL.
 
message has usage pointer.
Parameters
 
Remarks
This call creates a new message from a byte sequence and populates the message with data.
This function allocates the storage for the new message. Your program owns the messages that it creates, and must destroy those messages to reclaim the storage. That is, each call to this function must be paired with a call to tibemsMsg_Destroy.
The new message is independent of the original byte sequence. They do not share any storage.
The newly created message is read-only; to enable modification without erasing the content, call tibemsMsg_MakeWriteable.
See Also
tibemsMsg_Destroy on page 31
tibemsMsg_GetAsBytes on page 32
tibemsMsg_GetAsBytesCopy on page 33
tibemsMsg_MakeWriteable on page 53

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved