Функция DeleteAce (securitybaseapi.h)

Статья
03/05/2024

Функция DeleteAce удаляет запись управления доступом (ACE) из списка управления доступом (ACL).

Синтаксис

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

Параметры

[in, out] pAcl

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

[in] dwAceIndex

Удаляемая функция ACE. Нулевое значение соответствует первому ACE в ACL, значению от одного до второго ACE и т. д.

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

Если функция выполнена успешно, функция возвращает ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Приложение может использовать структуру ACL_SIZE_INFORMATION , полученную функцией GetAclInformation , для обнаружения размера списка ACL и количества содержащихся в нем ACL. Функция GetAce извлекает сведения об отдельном ACE.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll