RpcSsDestroyClientContext

The RpcSsDestroyClientContext function destroys a context handle no longer needed by the client without contacting the server.

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

Parameters

ContextHandle
Specifies the context handle to be destroyed. The handle is set to NULL before RpcSsDestroyClientContext returns.

Remarks

RpcSsDestroyClientContext is used by the client application to reclaim the memory resources used to maintain a context handle on the client. This function is used when ContextHandle is no longer valid, such as when a communication failure has occurred and the server is no longer available. The context handle is set to NULL.

Do not use RpcSsDestroyClientContext to replace a server function that closes the context handle.

Return Values

Value Meaning
RPC_S_OK Success
RPC_X_SS_CONTEXT_MISMATCH Invalid context handle

QuickInfo

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

See Also

RpcBindingReset