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

Статья
08/25/2023

Функция GetSecurityDescriptorSacl извлекает указатель на системный список управления доступом (SACL) в указанном дескрипторе безопасности.

Синтаксис

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

Параметры

[in] pSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , содержащую saCL, на который функция получает указатель.

[out] lpbSaclPresent

Указатель на флаг, который устанавливает функция, чтобы указать наличие saCL в указанном дескрипторе безопасности. Если этот параметр имеет значение TRUE, дескриптор безопасности содержит saCL, а остальные выходные параметры в этой функции получают допустимые значения. Если этот параметр имеет значение FALSE, дескриптор безопасности не содержит SACL, а остальные выходные параметры не получают допустимых значений.

[out] pSacl

Указатель на указатель на список управления доступом (ACL). Если saCL существует, функция устанавливает указатель, на который указывает pSacl , на адрес SACL дескриптора безопасности. Если saCL не существует, значение не сохраняется.

Если функция сохраняет значение NULL в указателе, на который указывает pSacl, дескриптор безопасности имеет null SACL.

[out] lpbSaclDefaulted

Указатель на флаг, который задается на значение флага SE_SACL_DEFAULTED в структуре SECURITY_DESCRIPTOR_CONTROL , если для дескриптора безопасности существует saCL.

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

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

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

Требования

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