Функция 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 может возвращать одно из следующих элементов.
| Код возврата | Описание |
|---|---|
|
Вызов успешно завершен. |
|
Вызывающий объект указал неподдерживаемое значение для параметра Revision. |
Комментарии
Успешный вызов этой подпрограммы инициализирует дескриптор безопасности. Поля в этом дескрипторе имеют начальные значения, указывающие на отсутствие ограничений безопасности.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим) |
| IRQL | PASSIVE_LEVEL |