[Enterprise Extensions only]

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.

IDL 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.