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

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

Синтаксис

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

Параметры

[in] pAcl

Указатель на список ACL, содержащий извлекаемую ACE.

[in] dwAceIndex

Индекс извлекаемого элемента ACE. Значение, равное нулю, соответствует первому ACE в ACL, значению одного — второму ACE и т. д.

[out] pAce

Указатель на указатель, который функция задает для адреса ACE.

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

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

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

Требования

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

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

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

Низкоуровневые контроль доступа

Низкоуровневые функции контроль доступа