次の方法で共有


GetExplicitEntriesFromAclA 関数 (aclapi.h)

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

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー aclapi.h
ライブラリ Advapi32.lib
DLL Advapi32.dll

関連項目

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACCESS_MODE

ACE

ACL

アクセス制御の

基本的なアクセス制御関数の

EXPLICIT_ACCESS

LocalFree

SYSTEM_AUDIT_ACE