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 |
| 程式庫 | Authz.lib |
| Dll | Authz.dll |
| 可轉散發套件 | Windows XP 上的 Windows Server 2003 系統管理工具套件 |