nf-rpcndr-rpcsmdestroyclientcontext.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:rpcndr.RpcSmDestroyClientContext	RpcSmDestroyClientContext function (rpcndr.h)	The RpcSmDestroyClientContext function reclaims the client memory resources for a context handle and makes the context handle NULL.	RpcSmDestroyClientContext RpcSmDestroyClientContext function [RPC] _rpc_rpcsmdestroyclientcontext rpc.rpcsmdestroyclientcontext rpcndr/RpcSmDestroyClientContext	rpc\rpcsmdestroyclientcontext.htm	Rpc	ae886740-09e9-46a1-aa62-5dbcf6abab36	12/05/2018	RpcSmDestroyClientContext, RpcSmDestroyClientContext function [RPC], _rpc_rpcsmdestroyclientcontext, rpc.rpcsmdestroyclientcontext, rpcndr/RpcSmDestroyClientContext	rpcndr.h	Rpc.h	Windows	Windows 2000 Professional [desktop apps \| UWP apps]	Windows 2000 Server [desktop apps \| UWP apps]										Rpcrt4.lib	Rpcrt4.dll		Windows			19H1	RpcSmDestroyClientContext rpcndr/RpcSmDestroyClientContext	c++	APIRef kbSyntax	DllExport	Rpcrt4.dll	RpcSmDestroyClientContext

RpcSmDestroyClientContext function

-description

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

-parameters

-param ContextHandle

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

-returns

Value	Meaning
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.

-see-also

RpcSsDestroyClientContext