BEA Logo BEA Tuxedo Release 8.0

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

   Tuxedo Documentation   |   C Function Reference   |   Local Topics   |   Previous Topic   |   Next Topic   |   Contents

 


rpc_sm_disable_allocate, rpc_ss_disable_allocate(3c)

Name

rpc_sm_disable_allocate(), rpc_ss_disable_allocate()—Releases resources and allocated memory within the stub memory management scheme.

Synopsis

#include <rpc/rpc.h> 
void rpc_sm_disable_allocate(unsigned32 *status);
void rpc_ss_disable_allocate(void);

Description

The rpc_sm_disable_allocate() routine releases all resources acquired by a call to rpc_sm_enable_allocate(), and any memory allocated by calls to rpc_sm_allocate() after the call to rpc_sm_enable_allocate() was made.

The rpc_sm_enable_allocate() and rpc_sm_disable_allocate() routines must be used in matching pairs. Calling this routine without a previous matching call to rpc_sm_enable_allocate() results in unpredictable behavior.

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_ss_disable_allocate() is the exception-returning version of this function and has no status output parameter. No exceptions are raised.

A thread in a multithreaded application may issue a call to rpc_sm_disable_allocate() or rpc_ss_disable_allocate() while running in any context state, including TPINVALIDCONTEXT.

Return Values

None.

See Also

rpc_sm_allocate, rpc_ss_allocate(3c), rpc_sm_enable_allocate, rpc_ss_enable_allocate(3c)

Programming BEA Tuxedo ATMI Applications Using TxRPC

 

back to top previous page next page