Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1

Header

Rpcndr.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcSsDestroyClientContext

 

 

Show:
© 2017 Microsoft