Функция GetExplicitEntriesFromAclA (aclapi.h)
Функция getExplicitEntriesFromAcl извлекает массив структур, описывающих записи управления доступом (ACEs) в списке управления доступом (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 структур, описывающих ACEs в 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] |
| целевая платформа | Виндоус |
| заголовка | aclapi.h |
| библиотеки |
Advapi32.lib |
| DLL | Advapi32.dll |
См. также