Функция RtlCreateSecurityDescriptor (wdm.h)

  • Статья

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

Синтаксис

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  ULONG                Revision
);

Параметры

[out] SecurityDescriptor

Указатель на буфер для инициализации SECURITY_DESCRIPTOR .

[in] Revision

Задает уровень редакции, назначаемого дескриптору безопасности. Задайте для этого параметра значение SECURITY_DESCRIPTOR_REVISION.

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

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

Код возврата Описание
STATUS_SUCCESS
 Вызов успешно завершен.
STATUS_UNKNOWN_REVISION
 Вызывающий объект указал неподдерживаемое значение для параметра Revision.

Комментарии

Успешный вызов этой подпрограммы инициализирует дескриптор безопасности. Поля в этом дескрипторе имеют начальные значения, указывающие на отсутствие ограничений безопасности.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях Windows.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL PASSIVE_LEVEL

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

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR