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


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

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

Синтаксис

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

Параметры

[out] SecurityDescriptor

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

[in] Revision

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

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

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

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

Замечания

В действительности успешный вызов этой подпрограммы инициализирует дескриптор безопасности без ограничений безопасности.

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
целевая платформа Настольный
заголовка ntifs.h (include Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

См. также

ACL

RtlCreateSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlSetOwnerSecurityDescriptor

RtlValidSecurityDescriptor