RpcFreeAuthorizationContext function (rpcasync.h)
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 |