Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
RpcSmDestroyClientContext
Collapse the table of content
Expand the table of content

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:
© 2015 Microsoft