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