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

Статья
02/29/2024

Подпрограмма RtlCreateSecurityDescriptorRelative инициализирует новый дескриптор безопасности в автономном формате. При возврате дескриптор безопасности инициализируется без системного ACL (SACL), без дискреционного ACL (DACL), без владельца, без основной группы, а все флаги управления равны нулю.

Синтаксис

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Параметры

[out] SecurityDescriptor

Указатель на буфер, выделенный вызывающим объектом, который должен быть по крайней мере sizeof(SECURITY_DESCRIPTOR_RELATIVE), чтобы получить инициализированный дескриптор безопасности.

[in] Revision

Уровень редакции, назначаемой дескриптору безопасности. Этот параметр должен быть SECURITY_DESCRIPTOR_REVISION.

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

RtlCreateSecurityDescriptorRelative может возвращать одно из следующих элементов:

Код возврата	Описание
STATUS_SUCCESS	Вызов успешно завершен.
STATUS_UNKNOWN_REVISION	Данная редакция не известна или не поддерживается.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000
Целевая платформа	Персональный компьютер
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL