RpcFreeAuthorizationContext function (rpcasync.h)

Article
02/22/2024

The RpcFreeAuthorizationContext function frees an Authz context obtained by a previous call to the RpcGetAuthorizationContextForClient function.

Syntax

RPC_STATUS RpcFreeAuthorizationContext(
  [in] PVOID *pAuthzClientContext
);

Parameters

[in] pAuthzClientContext

Pointer to the previously obtained Authz client context to be freed.

Return value

Successful completion returns RPC_S_OK. This function does not fail unless an invalid parameter is provided.

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

Remarks

The pAuthzClientContext parameter is a pointer to the Authz context, not the context itself. To prevent accidental reuse of the Authz context freed by this function call, RPC run-time zeros out the context upon return.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	rpcasync.h (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll