PreviousNext

rpc_sm_destroy_client_context(3rpc)

Reclaims the client memory resources for a context handle, and sets the context handle to 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. This status code indicates whether the routine completed successfully or, if not, why not.

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 sets the context handle to null.

Return Values
None.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

rpc_s_ok
Success.