NAME

rpc_ss_set_client_alloc_free - Sets the memory allocation and freeing mechanism used by the client stubs, thereby overriding the default routines the client stub uses to manage memory for pointed-to nodes

Used by client applications. 

SYNOPSIS

#include <dce/rpc.h>
void rpc_ss_set_client_alloc_free (
   idl_void_p_t (∗p_allocate) (
      unsigned long size),
   void (∗p_free) (
      idl_void_p_t ptr)
      );

PARAMETERS

Input

p_allocateSpecifies a pointer to a routine that has the same procedure declaration as the malloc routine and that is used by the client stub to allocate memory. 

p_freeSpecifies a pointer to a routine that has the same procedure declaration as the free routine and that is used to free memory that was allocated using the routine pointed at by p_allocate. 

(Note: In ANSI standard C environments, idl_void_p_t is defined as void ∗ and in other environments is defined as char ∗.) 

DESCRIPTION

The rpc_ss_set_client_alloc_free routine overrides the default routines that the client stub uses to manage memory for pointed-to nodes.  The default memory management routines are malloc and free except when the remote call occurs within manager code in which case the default memory management routines are rpc_ss_allocate and rpc_ss_free. 

See the Rules for Using Memory Management Routines in the Pointers section of the Interface Definition Language chapter in the NCS 2.0 Programmer’s Guide. 

RETURN VALUES

An exception, rpc_x_no_memory, when there is insufficient memory available to set up necessary data structures. 

EXAMPLES

None. 

RELATED INFORMATION

Functions: rpc_ss_allocate(3), rpc_ss_free(3)