Export (0) Print
Expand All
Expand Minimize

RpcSmDestroyClientContext function

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

Syntax


RPC_STATUS RPC_ENTRY RpcSmDestroyClientContext(
  void **ContextHandle
);

Parameters

ContextHandle

Context handle that can no longer be used. The handle is set to NULL before RpcSMDestroyClientContext returns.

Return value

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_X_SS_CONTEXT_MISMATCH

The handle is invalid.

 

Note  For a list of valid error codes, see RPC Return Values.

Remarks

Client applications use RpcSmDestroyClientContext to reclaim resources from an inactive context handle. Applications can call RpcSmDestroyClientContext after a communications error makes the context handle unusable. The RpcSmDestroyClientContext function provides the same functionality as the RpcSsDestroyClientContext function.

This function does not invoke the server's context handle run-down process.

When RpcSmDestroyClientContext reclaims the memory resources, it also makes the context handle NULL. For more information, see Using Context Handles.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Rpcndr.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcSsDestroyClientContext

 

 

Community Additions

ADD
Show:
© 2014 Microsoft