AuthzInitializeContextFromAuthzContext 函数 (authz.h)

  • 项目

AuthzInitializeContextFromAuthzContext 函数基于现有客户端上下文创建新的客户端上下文。

从Windows Server 2012和Windows 8开始，此函数还会复制设备组、用户声明和设备声明。

语法

AUTHZAPI BOOL AuthzInitializeContextFromAuthzContext(
  [in]           DWORD                        Flags,
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE  hAuthzClientContext,
  [in, optional] PLARGE_INTEGER               pExpirationTime,
  [in]           LUID                         Identifier,
  [in]           PVOID                        DynamicGroupArgs,
  [out]          PAUTHZ_CLIENT_CONTEXT_HANDLE phNewAuthzClientContext
);

参数

[in] Flags

保留供将来使用。

[in] hAuthzClientContext

现有客户端上下文的句柄。

[in, optional] pExpirationTime

设置返回的上下文结构有效时长的时间限制。 如果未传递任何值，则令牌永远不会过期。 当前未强制实施过期时间。

[in] Identifier

资源管理器的特定标识符。

[in] DynamicGroupArgs

指向要传递给计算动态组的回调函数的参数的指针。 如果值为 NULL，则不调用回调函数。

[out] phNewAuthzClientContext

指向重复AUTHZ_CLIENT_CONTEXT_HANDLE句柄的指针。 使用完 句柄后，通过调用 AuthzFreeContext 函数释放它。

返回值

如果该函数成功，则返回 TRUE。

如果函数失败，则返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

此函数调用 AuthzComputeGroupsCallback 回调函数，将 安全标识符 添加到新创建的上下文。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 authz.h
Library Authz.lib
DLL Authz.dll
可再发行组件 Windows XP 上的 Windows Server 2003 管理工具包

另请参阅

AUTHZ_ACCESS_REPLY

基本访问控制函数