GetExplicitEntriesFromAclW

アクセス制御リスト (ACL) 内のアクセス制御エントリ (ACE) を記述する構造体の配列を取得する。(Unicode)

GetExplicitEntriesFromAclW pacl, pcCountOfExplicitEntries, pListOfExplicitEntries

pacl : [var] ACE 情報を取得する元となる ACL 構造体へのポインタ。
pcCountOfExplicitEntries : [var] pListOfExplicitEntries 配列で返される EXPLICIT_ACCESS 構造体の数を受け取る変数へのポインタ。
pListOfExplicitEntries : [var] ACL 内の ACE を記述する EXPLICIT_ACCESS 構造体の配列へのポインタを受け取る変数へのポインタ。関数が成功した場合、LocalFree 関数を呼び出して返されたバッファを解放しなければならない。

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

解説

アクセス制御リスト (ACL) 内のアクセス制御エントリ (ACE) を記述する構造体の配列を取得する。(Unicode)

[戻り値]
関数が成功した場合、ERROR_SUCCESS を返す。失敗した場合、WinError.h で定義されるゼロ以外のエラーコードを返す。

[備考]
EXPLICIT_ACCESS 構造体の配列内の各エントリは、受益者用の ACE
からのアクセス制御情報を記述する。受益者はユーザー、グループ、またはプログラム (Windows サービスなど) である。各
EXPLICIT_ACCESS 構造体は、アクセス権のセットと、ACE が指定した権限を許可、拒否、または監査するかを示すアクセス モード
フラグを指定する。任意アクセス制御リスト (DACL) の場合、アクセス モード フラグは GRANT_ACCESS または
DENY_ACCESS を指定できる。これらの値の詳細は ACCESS_MODE を参照。システム アクセス制御リスト (SACL)
の場合、アクセス モード フラグは
SET_AUDIT_ACCESS、SET_AUDIT_FAILURE、またはその両方を指定できる。これらの値の詳細は
ACCESS_MODE を参照。
> [!NOTE] > aclapi.h ヘッダーは GetExplicitEntriesFromAcl
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode
版を自動的に選択する。エンコーディングに依存しないエイリアスと、エンコーディングに依存しないコードとを混在させると、コンパイルエラーや実行時エラーを引き起こす不整合が生じる可能性がある。詳細は
[関数プロトタイプの規約](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報