Функция GetExplicitEntriesFromAclA (aclapi.h)
Функция 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 |