NAME

   rpc_sm_enable_allocate - Enables the stub memory managment environment

 SYNOPSIS

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

 PARAMETERS

   Output

   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.

 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.  For server
   manager code called from the 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.

   For a discussion of how spawned threads acquire a stub memory
   management environment, see the rpc_sm_get_thread_handle and
   rpc_sm_set_thread_handle reference pages.

 RETURN VALUES

   None

 RELATED INFORMATION

   Functions: rpc_sm_allocate
              rpc_sm_disable_allocate