GetAclInformation 関数 (securitybaseapi.h)

[アーティクル]
03/01/2024

GetAclInformation 関数は、アクセス制御リスト (ACL) に関する情報を取得します。

構文

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

パラメーター

[in] pAcl

ACL へのポインター。関数は、この ACL に関する情報を取得します。 null 値が渡された場合、関数はアクセス違反を引き起こします。

[out] pAclInformation

要求された情報を受け取るバッファーへのポインター。バッファーに配置される構造体は、 dwAclInformationClass パラメーターで要求された情報クラスによって異なります。

[in] nAclInformationLength

pAclInformation パラメーターが指すバッファーのサイズ (バイト単位)。

[in] dwAclInformationClass

要求された情報のクラスを示す ACL_INFORMATION_CLASS 列挙の値。このパラメーターには、この列挙の 2 つの値のいずれかを指定できます。

値が AclRevisionInformation の場合、 関数は pAclInformation パラメーターが指すバッファーに ACL_REVISION_INFORMATION 構造体を格納します。
値が AclSizeInformation の場合、 関数は pAclInformation パラメーターが指すバッファーに ACL_SIZE_INFORMATION 構造体を格納します。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

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