Функция GetExplicitEntriesFromAclA (aclapi.h)

Статья
08/22/2023

Функция GetExplicitEntriesFromAcl извлекает массив структур, описывающих записи управления доступом (ACE) в списке управления доступом (ACL).

Синтаксис

DWORD GetExplicitEntriesFromAclA(
  [in]  PACL               pacl,
  [out] PULONG             pcCountOfExplicitEntries,
  [out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);

Параметры

[in] pacl

Указатель на структуру ACL , из которой нужно получить сведения об ACE .

[out] pcCountOfExplicitEntries

Указатель на переменную, которая получает количество EXPLICIT_ACCESS структур, возвращаемых в массиве pListOfExplicitEntries .

[out] pListOfExplicitEntries

Указатель на переменную, получающую указатель на массив EXPLICIT_ACCESS структур, описывающих ACE в списке ACL. Если функция выполнена успешно, необходимо вызвать функцию LocalFree , чтобы освободить возвращенный буфер.

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

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

Если функция завершается сбоем, она возвращает ненулевой код ошибки, определенный в WinError.h.

Каждая запись в массиве EXPLICIT_ACCESS структур описывает сведения об управлении доступом от ACE для доверенного лица. Доверенным лицом может быть пользователь, группа или программа (например, служба Windows).

Каждая структура EXPLICIT_ACCESS указывает набор прав доступа и флаг режима доступа, который указывает, разрешает ли ACE, запрещает или проверяет указанные права.

Для списка управления доступом на уровне пользователей (DACL) флаг режима доступа может быть GRANT_ACCESS или DENY_ACCESS. Сведения об этих значениях см . в разделе ACCESS_MODE.

Для системного списка управления доступом (SACL) флаг режима доступа может быть SET_AUDIT_ACCESS, SET_AUDIT_FAILURE или и то, и другое. Сведения об этих значениях см . в разделе ACCESS_MODE.

Примечание

Заголовок aclapi.h определяет GetExplicitEntriesFromAcl как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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