GetExplicitEntriesFromAclA 関数 (aclapi.h)
GetExplicitEntriesFromAcl 関数は、アクセス制御リスト (ACL) 内の アクセス制御エントリ (ACE) を記述する構造体の配列を取得します。
構文
DWORD GetExplicitEntriesFromAclA(
[in] PACL pacl,
[out] PULONG pcCountOfExplicitEntries,
[out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);
パラメーター
[in] pacl
ACE 情報を取得する
[out] pcCountOfExplicitEntries
pListOfExplicitEntries 配列で返される EXPLICIT_ACCESS 構造体の数を受け取る変数へのポインター。
[out] pListOfExplicitEntries
ACL 内の ACE を記述する EXPLICIT_ACCESS 構造体の配列へのポインターを受け取る変数へのポインター。 関数が成功した場合は、LocalFree 関数を呼び出して、返されたバッファーを解放する必要があります。
戻り値
関数が成功した場合、関数はERROR_SUCCESSを返します。
関数が失敗した場合、WinError.h で定義された 0 以外のエラー コードが返されます。
備考
EXPLICIT_ACCESS 構造体の配列内の各エントリは、トラスティの ACE からのアクセス制御情報を記述します。 トラスティには、ユーザー、グループ、またはプログラム (Windows サービスなど) を指定できます。
各 EXPLICIT_ACCESS 構造体は、アクセス権のセットと、ACE が指定した権限を許可、拒否、または監査するかどうかを示すアクセス モード フラグを指定します。
随意アクセス制御リスト (DACL) の場合、アクセス モード フラグはGRANT_ACCESSまたはDENY_ACCESSにすることができます。 これらの値の詳細については、ACCESS_MODEを参照してください。
システム アクセス制御リスト (SACL) の場合、アクセス モード フラグはSET_AUDIT_ACCESS、SET_AUDIT_FAILURE、またはその両方にすることができます。 これらの値の詳細については、ACCESS_MODEを参照してください。
手記
aclapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetExplicitEntriesFromAcl を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows XP [デスクトップ アプリ |UWP アプリ] |
サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリ |UWP アプリ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | aclapi.h |
ライブラリ | Advapi32.lib |
DLL | Advapi32.dll |