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