AddAccessAllowedAce

アクセス制御リスト (ACL) にアクセス許可アクセス制御エントリ (ACE) を追加する。アクセスは指定したセキュリティ識別子 (SID) に対して許可される。

AddAccessAllowedAce pAcl, dwAceRevision, AccessMask, pSid

pAcl : [var] ACL へのポインタ。本関数はこの ACL の末尾にアクセス許可 ACE を追加する。ACE は ACCESS_ALLOWED_ACE 構造体の形式で格納される。
dwAceRevision : [int] 変更する ACL のリビジョンレベルを指定する。
AccessMask : [int] 指定した SID に許可するアクセス権のマスクを指定する。
pSid : [int] アクセスを許可するユーザー、グループ、またはログオンアカウントを表す SID へのポインタ。

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

解説

アクセス制御リスト (ACL) にアクセス許可アクセス制御エントリ (ACE) を追加する。アクセスは指定したセキュリティ識別子
(SID) に対して許可される。

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

[備考]
ACL へのアクセス許可 ACE の追加は、ACL 変更の最も一般的な形態である。AddAccessAllowedAce および
AddAccessDeniedAce 関数は、ACL の ACE リストの末尾に新しい ACE を追加する。これらの関数は、新しい ACE
を正しい正規順序に自動的には配置しない。正しい順序で ACE を追加し、ACL
が正規順序になるようにするのは呼び出し側の責任である。AddAccessAllowedAce 関数が ACE に配置する
ACE_HEADER 構造体は、種類とサイズを指定するが、継承情報や ACE フラグは設定しない。

情報