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


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

Подпрограмма 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

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

ACL

RtlCreateSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlSetOwnerSecurityDescriptor

RtlValidSecurityDescriptor