tibemsBytesMsg_GetBytes

Function

Purpose

Get the body data of a bytes message.

C Declaration

tibems_status tibemsBytesMsg_GetBytes(
    tibemsBytesMsg message,
    void** bytes,
    tibems_uint* byteSize );

COBOL Call

CALL "tibemsBytesMsg_GetBytes"
 USING BY VALUE message,
       BY REFERENCE bytes,
       BY REFERENCE byteSize,
       RETURNING tibems-status
END-CALL.
Note: message and bytes have usage pointer.

Parameters

Parameter Description
message Get the byte sequence of this bytes message.
bytes Store a pointer to the bytes of the message in this location.

Your program must not change the bytes, which belong to the message; if you must modify the bytes, make a private copy first.

byteSize Store the length of the byte sequence.

Remarks

This call extracts a pointer to the body data of a bytes message.

The byte sequence storage persists until your program destroys the message object.