WebSphere Message Service Client for C/C++, Version 2.0.2 Operating Systems: AIX, Linux, Solaris, Windows

C++ methods that return a byte array

This topic describes the interface used by C++ methods that return a byte array.

In the C++ API, certain methods return a byte array as a parameter. Each of these methods uses the same interface for retrieving a byte array. The following example illustrates one of these methods, PropertyContext.getBytesProperty():

xmsINT getBytesProperty(const String & propertyName,
                        xmsSBYTE *propertyValue,
                        const xmsINT length,
                        xmsINT *actualLength) const;

The parameters propertyValue, length, and actualLength control the retrieval of the byte array in the same way as described in C functions that return a byte array by value.

Other examples of these methods are MapMessage.getBytes(), MapMessage.getObject(), Property.getByteArray(), and String.get().


Concept topic

Terms of Use | Rate this page

Last updated: 24 May 2011

(C) Copyright IBM Corporation 2005, 2011. All Rights Reserved.