Функция 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 для разработчиков драйверов и документации по этим разделам в пакете SDK для Windows.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Server 2003 с пакетом обновления 1 (SP1) |
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |