Function
Set a byte array as a named value in a map message.
tibems_status
tibemsMapMsg_SetBytes(tibemsMapMsg
message, const char* name, void* bytes,tibems_uint
bytesSize );tibems_status
tibemsMapMsg_SetReferencedBytes(tibemsMapMsg
message, const char* name, void* bytes,tibems_uint
bytesSize );
CALL "tibemsMapMsg_SetBytes" USING BY VALUE message, BY REFERENCE name, BY REFERENCE bytes, BY VALUE bytesSize, RETURNING tibems-status END-CALL. CALL "tibemsMapMsg_SetReferencedBytes" USING BY VALUE message, BY REFERENCE name, BY REFERENCE bytes, BY VALUE bytesSize, RETURNING tibems-status END-CALL.
tibemsMapMsg_SetBytes copies the byte array into the map message field. The program may free the orignal byte array after this call returns.
tibemsMapMsg_SetReferencedBytes adds a reference to the byte array, but does not copy the bytes. When the byte array is very large, it can be more efficient to avoid making a copy. However, the program must not free nor modify the original byte array until after freeing the map message.
TIBCO Enterprise Message Service™ C and COBOL Reference System Release 4.3, February 2006 Copyright © TIBCO Software Inc. All rights reserved www.tibco.com |