Функция RtlGetSaclSecurityDescriptor (ntifs.h)

Статья
02/07/2025

Подпрограмма RtlGetSaclSecurityDescriptor возвращает указатель на системный ACL (SACL) для дескриптора безопасности.

Синтаксис

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

Параметры

[in] SecurityDescriptor

Указатель на SECURITY_DESCRIPTOR, для которого необходимо вернуть SACL.

[out] SaclPresent

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

[out] Sacl

Указатель на переменную, получающую адрес SACL для дескриптора безопасности. Если дескриптор безопасности не имеет SACL, эта переменная не получает значение. Если дескриптор безопасности содержит NULL SACL, эта переменная получает NULL.

[out] SaclDefaulted

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

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

RtlGetSaclSecurityDescriptor возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее:

Возвращаемый код	Описание
STATUS_UNKNOWN_REVISION	Уровень редакции дескриптора безопасности неизвестен или не поддерживается. Это код ошибки.

Замечания

Дополнительные сведения о безопасности и управлении доступом см. в модели безопасности Windows для разработчиков драйверов и документации по этим разделам в пакете SDK для Windows.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Server 2003 с пакетом обновления 1 (SP1)
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL