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 系統管理工具套件

另請參閱

AuthzFreeContext

基本 存取控制 函式