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 管理工具包

另请参阅

AuthzFreeContext

基本访问控制函数