AuthzInitializeContextFromToken 函数 (authz.h)
AuthzInitializeContextFromToken 函数从内核令牌初始化客户端授权上下文。 内核令牌必须已打开TOKEN_QUERY。
从Windows Server 2012和Windows 8开始,此函数还可以复制设备组、用户声明和设备声明。
语法
AUTHZAPI BOOL AuthzInitializeContextFromToken(
[in] DWORD Flags,
[in] HANDLE TokenHandle,
[in] AUTHZ_RESOURCE_MANAGER_HANDLE hAuthzResourceManager,
[in, optional] PLARGE_INTEGER pExpirationTime,
[in] LUID Identifier,
[in, optional] PVOID DynamicGroupArgs,
[out] PAUTHZ_CLIENT_CONTEXT_HANDLE phAuthzClientContext
);
参数
[in] Flags
保留供将来使用。
[in] TokenHandle
用于初始化 pAuthzClientContext 参数的客户端令牌的句柄。 必须已使用TOKEN_QUERY访问权限打开令牌。
[in] hAuthzResourceManager
创建此客户端上下文的资源管理器的句柄。 此句柄存储在客户端上下文结构中。
[in, optional] pExpirationTime
令牌的过期日期和时间。 如果未传递任何值,则令牌永远不会过期。 当前未强制实施过期时间。
[in] Identifier
特定于资源管理器的标识符。 当前未使用此参数。
[in, optional] DynamicGroupArgs
指向要传递给计算动态组的回调函数的参数的指针。
[out] phAuthzClientContext
指向返回的 AuthzClientContext 句柄的指针。 使用客户端上下文时调用 AuthzFreeContext 。
返回值
如果该函数成功,则返回 TRUE。
如果函数失败,则返回 FALSE。 要获得更多的错误信息,请调用 GetLastError。
注解
此函数调用 AuthzComputeGroupsCallback 回调函数,将 安全标识符 添加到新创建的上下文。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | authz.h |
Library | Authz.lib |
DLL | Authz.dll |
可再发行组件 | Windows XP 上的 Windows Server 2003 管理工具包 |