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

Статья
03/08/2023

Подпрограмма 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, эта переменная не получает значение. Если дескриптор безопасности имеет список SACL NULL , эта переменная получает значение NULL.

[out] SaclDefaulted

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Server 2003 с пакетом обновления 1 (SP1)
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL