GetExplicitEntriesFromAclA 関数 (aclapi.h)

[アーティクル]
08/22/2023

GetExplicitEntriesFromAcl 関数は、アクセス制御リスト (ACL) 内のアクセス制御エントリ (ACE) を記述する構造体の配列を取得します。

構文

DWORD GetExplicitEntriesFromAclA(
  [in]  PACL               pacl,
  [out] PULONG             pcCountOfExplicitEntries,
  [out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);

パラメーター

[in] pacl

ACE 情報を取得する ACL 構造体へのポインター。

[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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	aclapi.h
Library	Advapi32.lib
[DLL]	Advapi32.dll