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

Статья
02/07/2025

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

Синтаксис

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Параметры

[in, out] SecurityDescriptor

Указатель на SECURITY_DESCRIPTOR структуру, владелец которой должен быть задан. RtlSetOwnerSecurityDescriptor заменяет любого существующего владельца новым владельцем.

[in, optional] Owner

Указатель на структуру идентификатора безопасности (sid) нового владельца дескриптора безопасности. Этот указатель, а не сама структура SID, копируется в дескриптор безопасности. Если этот параметр null, RtlSetOwnerSecurityDescriptor очищает сведения о владельце дескриптора безопасности. Это означает, что дескриптор безопасности не имеет владельца.

[in, optional] OwnerDefaulted

Задайте значение TRUE, если сведения о владельце являются производными от механизма по умолчанию. Если это значение равно TRUE, это сведения по умолчанию. RtlSetOwnerSecurityDescriptor задает флаг SE_OWNER_DEFAULTED в поле SECURITY_DESCRIPTOR_CONTROL дескриптора безопасности. Если этот параметр FALSE, флаг SE_OWNER_DEFAULTED очищается.

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

RtlSetOwnerSecurityDescriptor может возвращать один из следующих кодов состояния:

Возвращаемый код	Описание
STATUS_SUCCESS	Владелец был успешно установлен или сброшен.
STATUS_UNKNOWN_REVISION	Версия дескриптора безопасности не распознается этой подпрограммой.
STATUS_INVALID_SECURITY_DESCR	Заданный дескриптор безопасности не является допустимым абсолютным дескриптором безопасности.

Замечания

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

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe (режим ядра); Ntdll.dll (режим пользователя)
IRQL	< DISPATCH_LEVEL