次の方法で共有


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

要件

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

こちらもご覧ください

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACCESS_MODE

エース

ACL

アクセス制御

基本的なAccess Control関数

EXPLICIT_ACCESS

LocalFree

SYSTEM_AUDIT_ACE