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

基本的なAccess Control関数