RequestSeq::allocbuf

Overview Allocates a sequence of pointers to Request elements.
Original class CORBA::RequestSeq


Intended Usage

The allocbuf method is used by a client program to allocate a sequence of pointers to Request elements. The pointers are initialized to NULL. The newly allocated buffer can be passed to the "CORBA::Request_ptr *" constructor. Memory allocated using the allocbuf method must be freed using the freebuf method or by transferring ownership to a RequestSeq object.

Syntax

  CORBA::Request_ptr allocbuf(CORBA::ULong nelems);

Input parameters

nelems
The number of pointers to Request elements to be allocated. The requested number of elements must be greater than zero.

Return values

CORBA::Request_ptr *
A pointer to the address of the newly allocated sequence of pointers to Request elements. Ownership of the return value transfers to the caller. If the allocbuf method fails, a null pointer is returned.

Related reference
CORBA module



Searchable topic ID:   rcor_modrs1
Last updated: Jun 21, 2007 8:07:48 PM CDT    WebSphere Business Integration Server Foundation, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.wasee.doc/info/ee/corba/ref/rcor_modrs1.html

Library | Support | Terms of Use | Feedback