Function
Read a byte array from a stream message.
tibems_status
tibemsStreamMsg_ReadBytes(tibemsStreamMsg
message, void** value,tibems_uint
* length );
CALL "tibemsStreamMsg_ReadBytes" USING BY VALUE message, BY REFERENCE value, BY REFERENCE size, RETURNING tibems-status END-CALL.
Each call reads bytes from the stream into the byte array, and advances the read position so that the next read call gets the next datum. (Other read functions are documented on separate pages.)
This call uses the length
parameter to return the actual number of bytes read. When the call cannot read even one byte, the length
is -1.
A program that calls this function must call it repeatedly until it returns -1, indicating that the program has extracted the complete set of bytes. Only then may the program call another read function.
TIBCO Enterprise Message Service™ C and COBOL Reference System Release 4.3, February 2006 Copyright © TIBCO Software Inc. All rights reserved www.tibco.com |