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 |
See Also