Поделиться через


Функция 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

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

ACCESS_ALLOWED_ACE

ACCESS_DENIED_ACE

ACCESS_MODE

ACE

ACL

Управление доступом

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

EXPLICIT_ACCESS

LocalFree

SYSTEM_AUDIT_ACE