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

Статья
08/25/2023

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

Синтаксис

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

Параметры

[in] pAcl

Указатель на список ACL. Функция извлекает сведения об этом ACL. Если передается значение NULL, функция вызывает нарушение доступа.

[out] pAclInformation

Указатель на буфер для получения запрошенной информации. Структура, помещаемая в буфер, зависит от класса сведений, запрошенного в параметре dwAclInformationClass .

[in] nAclInformationLength

Размер (в байтах) буфера, на который указывает параметр pAclInformation .

[in] dwAclInformationClass

Значение перечисления ACL_INFORMATION_CLASS , указывающее класс запрашиваемых сведений. Этот параметр может иметь одно из двух значений из перечисления :

Если значение равно AclRevisionInformation, функция заполняет буфер, на который указывает параметр pAclInformation , структурой ACL_REVISION_INFORMATION .
Если значение равно AclSizeInformation, функция заполняет буфер, на который указывает параметр pAclInformation , ACL_SIZE_INFORMATION структурой.

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

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

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

Требования

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