AddAccessAllowedAceEx

任意アクセス制御リスト (DACL) の末尾にアクセス許可アクセス制御エントリ (ACE) を追加する。(AddAccessAllowedAceEx)

AddAccessAllowedAceEx pAcl, dwAceRevision, AceFlags, AccessMask, pSid

pAcl : [var] DACL へのポインタ。AddAccessAllowedAceEx 関数はこの DACL の末尾にアクセス許可 ACE を追加する。ACE は ACCESS_ALLOWED_ACE 構造体の形式で格納される。
dwAceRevision : [int] 変更する DACL のリビジョンレベルを指定する。この値には ACL_REVISION または ACL_REVISION_DS を指定できる。DACL にオブジェクト固有の ACE が含まれる場合は ACL_REVISION_DS を使用する。
AceFlags : [int] ACE の継承を制御するビットフラグのセット。関数はこれらのフラグを AceFlags メンバに設定する。
AccessMask : [int] ACCESS_MASK 形式のビットフラグのセット。これらのフラグは、新しい ACE が指定した SID に対して許可するアクセス権を指定する。
pSid : [int] 新しい ACE がアクセスを許可するユーザー、グループ、またはログオンセッションを識別する SID へのポインタ。

(プラグイン / モジュール : advapi32.dll)

解説

任意アクセス制御リスト (DACL) の末尾にアクセス許可アクセス制御エントリ (ACE)
を追加する。(AddAccessAllowedAceEx)

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼び出す。以下のエラー値が返される可能性がある。
（以下省略）

[備考]
呼び出し側は、ACE を正しい順序で DACL に追加する必要がある。詳細は「Order of ACEs in a
DACL」を参照のこと。

情報