AddAce

指定したアクセス制御リスト (ACL) に 1 つ以上のアクセス制御エントリ (ACE) を追加する。

AddAce pAcl, dwAceRevision, dwStartingAceIndex, pAceList, nAceListLength

pAcl : [var] ACL へのポインタ。本関数はこの ACL に ACE を追加する。
dwAceRevision : [int] 変更する ACL のリビジョンレベルを指定する。
dwStartingAceIndex : [int] 新しい ACE を追加する、ACL の ACE リスト内の位置を指定する。0 を指定するとリストの先頭に挿入され、MAXDWORD を指定するとリストの末尾に追加される。
pAceList : [intptr] 指定した ACL に追加する 1 つ以上の ACE のリストへのポインタ。リスト内の ACE は連続して格納されている必要がある。
nAceListLength : [int] pAceList パラメータが指す入力バッファのサイズ（バイト単位）。

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

解説

指定したアクセス制御リスト (ACL) に 1 つ以上のアクセス制御エントリ (ACE) を追加する。

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

[備考]
アプリケーションは、ACL を操作する目的で AddAce 関数を使用する際に、FindFirstFreeAce および GetAce
関数をよく併用する。また、GetAclInformation 関数で取得できる ACL_SIZE_INFORMATION
構造体には、ACL のサイズと含まれる ACE の数が格納されている。

情報