AuthzInitializeContextFromAuthzContext function
Applies to: desktop apps only
The AuthzInitializeContextFromAuthzContext function creates a new client context based on an existing client context.
Starting with Windows Server 8 Beta and Windows 8 Consumer Preview, this function also duplicates device groups, user claims, and device claims.
Syntax
BOOL WINAPI AuthzInitializeContextFromAuthzContext( __in DWORD flags, __in AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext, __in_opt PLARGE_INTEGER pExpirationTime, __in LUID Identifier, __in PVOID DynamicGroupArgs, __out PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext );
Parameters
- flags [in]
-
Reserved for future use.
- hAuthzClientContext [in]
-
The handle to an existing client context.
- pExpirationTime [in, optional]
-
Sets the time limit for how long the returned context structure is valid. If no value is passed, then the token never expires. Expiration time is not currently enforced.
- Identifier [in]
-
The specific identifier for the resource manager.
- DynamicGroupArgs [in]
-
A pointer to parameters to be passed to the callback function that computes dynamic groups. If the value is NULL, then the callback function is not called.
- phNewAuthzClientContext [out]
-
A pointer to the duplicated AUTHZ_CLIENT_CONTEXT_HANDLE handle. When you have finished using the handle, release it by calling the AuthzFreeContext function.
Return value
If the function succeeds, it returns TRUE.
If the function fails, it returns FALSE. To get extended error information, call GetLastError.
Remarks
This function calls the AuthzComputeGroupsCallback callback function to add security identifiers to the newly created context.
Requirements
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Redistributable | Windows Server 2003 Administration Tools Pack on Windows XP |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 3/7/2012
