RpcSmDestroyClientContext

The RpcSmDestroyClientContext function reclaims the client memory resources for a context handle and makes the context handle NULL.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcSmDestroyClientContext( 
  void* *  ContextHandle  
);

Parameters

ContextHandle
Specifies the context handle that can no longer be used.

Remarks

The RpcSmDestroyClientContext routine is used by client applications to reclaim resources used for an inactive context handle. Applications can call RpcSmDestroyClientContext after a communications error makes the context handle unusable.

Note that when this routine reclaims the memory resources, it also makes the context handle NULL.

Return Values

Value Meaning
RPC_S_OK Success
RPC_X_SS_CONTEXT_MISMATCH Invalid handle

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcndr.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcSmFree, RpcSmGetThreadHandle, RpcSmSetClientAllocFree, RpcSmSetThreadHandle, RpcSmSwapClientAllocFree