NAME

rpc_sm_destroy_client_context-reclaims the client memory resources for a context handle, and makes the context handle null

SYNOPSIS

#include <rpc.h>

void rpc_sm_destroy_client_context(
 	idl_void_p_t p_unusable_context_handle,
	unsigned32 *status);

PARAMETERS

Input

p_unusable_context_handle

Specifies the context handle that can no longer be accessed.

Output

status

Returns the status code from this routine. The 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

The rpc_sm_destroy_client_context() routine is used by client applications to reclaim the client resources used in maintaining an active context handle. Applications call this routine after a communications error makes the context handle unusable.

When the rpc_sm_destroy_client_context() routine reclaims the memory resources, it also makes the context handle null.

RETURN VALUE

None.

SEE ALSO

rpc_sm_allocate()
rpc_sm_enable_allocate().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.