RtlDeleteAce 関数 (ntifs.h)

RtlDeleteAce ルーチンは、指定されたアクセス制御リスト (ACL) からアクセス制御エントリ (ACE) を削除します。

構文

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);

パラメーター

[in, out] Acl

変更する ACL へのポインター。 RtlDeleteAce は 、指定された ACE をこの ACL から削除します。

[in] AceIndex

削除する ACE を指定します。 値 0 は、ACL の最初の ACE に対応し、1 は 2 番目の ACE に対応します。

戻り値

RtlDeleteAce は 、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターン コード	説明
STATUS_INVALID_PARAMETER	パラメーター値の 1 つが無効です。

STATUS_INVALID_PARAMETERの考えられる理由は次のとおりです。

• 指定された ACL が無効です。
• 指定したインデックス値が範囲外です。
• STATUS_INVALID_PARAMETERはエラー コードです。

注釈

ACL のサイズの計算については、 RtlCreateAcl のリファレンス エントリの「解説」セクションを参照してください。

ACL に ACE を追加するには、 RtlAddAce を使用します。

ACL 内の ACE へのポインターを取得するには、 RtlGetAce を使用します。

セキュリティとアクセス制御の詳細については、 ドライバー開発者向けの Windows セキュリティ モデル と、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2003 SP1
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL

こちらもご覧ください

エース

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce