Allocation and Deallocation Functions

This function is used to allocate and initiate the
CORBA_Environment structure. In particular, it is used
to dynamically allocate a CORBA_Environment structure and set
the default values for the structure's fields.

inbufsize is the initial size of the input
buffer.

outbufsize is the initial size of the output
buffer.

CORBA_Environment is the CORBA 2.0 state structure
used by the generated stub.

This function will set all needed default values and
allocate buffers the lengths of which are equal to the
values passed, but will not allocate space for the _to_pid
and _from_pid fields.

To free the space allocated by CORBA_Environment_alloc() do
as follows.

First call CORBA_free for the input and output buffers.

After freeing the buffer space, call CORBA_free for the
CORBA_Environment space.

void CORBA_free(void *p)

Frees allocated space pointed to by p.

CORBA_char * CORBA_string_alloc(CORBA_unsigned_long len)

Allocates a (simple) CORBA character string of length len + 1.

CORBA_wchar * CORBA_wstring_alloc(CORBA_unsigned_long len)

Allocates a CORBA wide string of length len + 1.

Exception Functions

Functions for retrieving exception ids and values, and for setting
exceptions.