DeleteAce 関数 (securitybaseapi.h)

DeleteAce 関数は、アクセス制御リスト (ACL) からアクセス制御エントリ (ACE) を削除します。

構文

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

[in, out] pAcl

ACL へのポインター。 dwAceIndex パラメーターで指定された ACE は、この ACL から削除されます。

[in] dwAceIndex

削除する ACE。値 0 は、ACL の最初の ACE、1 から 2 番目の ACE までの値に対応します。

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

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

アプリケーションは、GetAclInformation 関数によって取得されたACL_SIZE_INFORMATION構造体を使用して、ACL のサイズと ACL に含まれる ACE の数を検出できます。 GetAce 関数は、個々の ACE に関する情報を取得します。

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