AuthzCachedAccessCheck 関数 (authz.h)

[アーティクル]
02/23/2024

AuthzCachedAccessCheck 関数は、以前の AuthzAccessCheck 呼び出しから静的に許可されたビットを含むキャッシュされたハンドルに基づいて、高速アクセスチェックを実行します。

構文

AUTHZAPI BOOL AuthzCachedAccessCheck(
  [in]  DWORD                             Flags,
  [in]  AUTHZ_ACCESS_CHECK_RESULTS_HANDLE hAccessCheckResults,
  [in]  PAUTHZ_ACCESS_REQUEST             pRequest,
  [in]  AUTHZ_AUDIT_EVENT_HANDLE          hAuditEvent,
  [out] PAUTHZ_ACCESS_REPLY               pReply
);

パラメーター

[in] Flags

将来利用するために予約されています。

[in] hAccessCheckResults

キャッシュされたアクセスチェック結果へのハンドル。

[in] pRequest

目的のアクセスマスク、プリンシパルセルフ SID、およびオブジェクトの種類リスト構造 (存在する場合) を指定するアクセス要求ハンドル。

[in] hAuditEvent

オブジェクト固有の監査情報を含む構造体。このパラメーターの値が null でない場合は、監査が自動的に要求されます。静的監査情報は、リソースマネージャー構造から読み取られます。

[out] pReply

GrantedAccessMask/ErrorValue ペアの配列としてチェックアクセスの結果を返すAUTHZ_ACCESS_REPLY ハンドルへのポインター。返されるペアの数は、AUTHZ_ACCESS_REPLY構造体の ResultListLength メンバーの呼び出し元によって提供されます。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、 FALSE が返されます。詳細なエラー情報を得るには、GetLastError を呼び出します。

返される配列要素の Error メンバーの予期される値を次の表に示します。

リターンコード	説明
ERROR_SUCCESS	MAXIMUM_ALLOWEDを含まないすべてのアクセスビットが許可され、pReply パラメーターの GrantedAccessMask メンバーは 0 ではありません。
ERROR_PRIVILEGE_NOT_HELD	pRequest パラメーターの DesiredAccess メンバーにはACCESS_SYSTEM_SECURITYが含まれており、クライアントには SeSecurityPrivilege 特権がありません。
ERROR_ACCESS_DENIED	次の 1 つ以上が当てはまります。要求されたビットは許可されません。 MaximumAllowed ビットがオンで、許可されたアクセスが 0 です。 pRequest パラメーターの DesiredAccess メンバーは 0 です。

注釈

クライアントコンテキストポインターは、 AuthzHandle パラメーターに格納されます。クライアントコンテキストの構造は、 AuthzHandle の作成時とまったく同じである必要があります。この制限は、次のフィールドに対して行われます。

SID
RestrictedSids
特権

プライマリセキュリティ記述子とオプションのセキュリティ記述子配列へのポインターは、ハンドルの作成時に AuthzHandle に格納されます。これらのポインターは引き続き有効である必要があります。

AuthzCachedAccessCheck 関数は、AUTHZ_RM_FLAG_NO_CENTRAL_ACCESS_POLICIES フラグが使用されている場合など、CSP が無視されない限り、オブジェクトの中央アクセスポリシー (CAP) を評価した結果としてキャッシュを維持します。クライアントは AuthzFreeCentralAccessPolicyCache 関数を呼び出して、このキャッシュを解放できます。これには、必要に応じてキャッシュを再構築するために 、AuthzCachedAccessCheck の後続の呼び出しが必要であることに注意してください。

詳細については、「 AccessCheck のしくみ」および「一元化された承認ポリシーの概要」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	authz.h
Library	Authz.lib
[DLL]	Authz.dll
再頒布可能パッケージ	Windows XP の Windows Server 2003 管理ツールパック