FindFirstFreeAce 関数 (securitybaseapi.h)

FindFirstFreeAce 関数は、アクセス制御リスト (ACL) の最初のフリーバイトへのポインターを取得します。

構文

BOOL FindFirstFreeAce(
  [in]  PACL   pAcl,
  [out] LPVOID *pAce
);

[in] pAcl

ACL へのポインター。

[out] pAce

関数が返されたときに作成された ACL 内の最初の空き位置へのポインターのアドレス。 ACL が無効な場合、このパラメーターは NULL です。 ACL がいっぱいの場合、このパラメーターは ACL の直後のバイトを指します。

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

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

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