Share via

Функция RtlDeleteAce (ntifs.h)

  • Статья

Подпрограмма RtlDeleteAce удаляет запись управления доступом (ACE) из указанного списка управления доступом (ACL).

Синтаксис

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

Параметры

[in, out] Acl

Указатель на список ACL, который необходимо изменить. RtlDeleteAce удаляет указанный ACE из этого списка ACL.

[in] AceIndex

Указывает ACE для удаления. Нулевое значение соответствует первому ACE в ACL, 1 — второму ACE и т. д.

Возвращаемое значение

RtlDeleteAce возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата Описание
STATUS_INVALID_PARAMETER Одно из значений параметра было недопустимым.

Возможные причины STATUS_INVALID_PARAMETER:

  • Указанный список ACL недопустим.
  • Указанное значение индекса выходит за пределы диапазона.
  • STATUS_INVALID_PARAMETER — это код ошибки.

Комментарии

Сведения о вычислении размера ACL см. в разделе Примечания справочной записи для RtlCreateAcl.

Чтобы добавить ACE в список ACL, используйте RtlAddAce.

Чтобы получить указатель на ACE в ACL, используйте RtlGetAce.

Дополнительные сведения о безопасности и управлении доступом см. в статье Модель безопасности Windows для разработчиков драйверов и в документации по этим темам в Windows SDK.

Требования

Требование Значение
Минимальная версия клиента Windows Server 2003 с пакетом обновления 1 (SP1)
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также раздел

ACE

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce