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

Статья
03/08/2023

Подпрограмма 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 для разработчиков драйверов и в документации по этим темам в Windows SDK.

Требования

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