PURPOSE

rpc_sm_enable_allocate, rpc_ss_enable_allocate - Enables the stub memory management environment

SYNOPSIS

#include <rpc/rpc.h>
void rpc_sm_enable_allocate(unsigned32 *status)
void rpc_ss_enable_allocate(void)

DESCRIPTION

Applications can call rpc_sm_enable_allocate to establish a stub memory management environment in cases where one is not established by the stub itself. A stub memory management environment must be established before any calls are made to rpc_sm_allocate(3c). For service code called from the server stub, the stub memory management environment is normally established by the stub itself. Code that is called from other contexts needs to call rpc_sm_enable_allocate before calling rpc_sm_allocate (e.g., if the service code is called directly instead of from the stub).

The output parameter, status, returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not. Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_no_memory

Insufficient memory available to set up necessary data structures.

rpc_ss_enable_allocate is the exception-returning version of this function and has no status output parameter. The following exceptions are raised by this routine.

rpc_x_no_memory

Insufficient memory available to set up necessary data structures.

RETURN VALUES

None.

SEE ALSO

rpc_sm_allocate(3c),
rpc_sm_disable_allocate(3c),
BEA TUXEDO TxRPC Guide