AddAccessAllowedAceEx 関数 (securitybaseapi.h)

[アーティクル]
03/05/2024

AddAccessAllowedAceEx 関数は、随意アクセス制御リスト (DACL) の末尾にアクセス許可アクセス制御エントリ (ACE) を追加します。

構文

BOOL AddAccessAllowedAceEx(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceRevision,
  [in]      DWORD AceFlags,
  [in]      DWORD AccessMask,
  [in]      PSID  pSid
);

パラメーター

[in, out] pAcl

DACL へのポインター。 AddAccessAllowedAceEx 関数は、この DACL の末尾にアクセス許可 ACE を追加します。 ACE は、 ACCESS_ALLOWED_ACE 構造の形式です。

[in] dwAceRevision

変更する DACL のリビジョンレベルを指定します。この値は、ACL_REVISIONまたはACL_REVISION_DSできます。 DACL にオブジェクト固有の ACE が含まれている場合は、ACL_REVISION_DSを使用します。

[in] AceFlags

ACE 継承を制御するビットフラグのセット。この関数は、新しい ACE のACE_HEADER構造体の AceFlags メンバーにこれらのフラグを設定します。このパラメーターは、次の値と組み合わせて使用できます。

値	意味
CONTAINER_INHERIT_ACE	ACE はコンテナーオブジェクトによって継承されます。
INHERIT_ONLY_ACE	ACE は、アクセス制御リスト (ACL) が割り当てられているオブジェクトには適用されませんが、子オブジェクトによって継承できます。
INHERITED_ACE	継承された ACE を示します。このフラグを使用すると、オブジェクトのツリーのセキュリティを変更する操作で、オブジェクトに直接適用された ACE を変更せず、継承された ACE を変更できます。
NO_PROPAGATE_INHERIT_ACE	OBJECT_INHERIT_ACEビットとCONTAINER_INHERIT_ACE ビットは、継承された ACE には反映されません。
OBJECT_INHERIT_ACE	ACE は、非コンテナーオブジェクトによって継承されます。

[in] AccessMask

ACCESS_MASK形式を使用するビットフラグのセット。これらのフラグは、新しい ACE が指定したセキュリティ識別子 (SID) に対して許可するアクセス権を指定します。

[in] pSid

新しい ACE がアクセスを許可するユーザー、グループ、またはログオンセッションを識別する SID へのポインター。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。考えられるエラー値を次に示します。

リターンコード	説明
ERROR_ALLOTTED_SPACE_EXCEEDED	新しい ACE は ACL に適合しません。より大きな ACL バッファーが必要です。
ERROR_INVALID_ACL	指定された ACL が正しく形成されていません。
ERROR_INVALID_FLAGS	AceFlags パラメーターが無効です。
ERROR_INVALID_SID	指定された SID が構造的に有効ではありません。
ERROR_REVISION_MISMATCH	指定されたリビジョンが不明であるか、ACL のリビジョンと互換性がありません。
ERROR_SUCCESS	ACE が正常に追加されました。

注釈

呼び出し元は、ACE が正しい順序で DACL に追加されていることを確認する必要があります。詳細については、「DACL 内の ACE の順序」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	securitybaseapi.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll