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

Статья
03/08/2023

Подпрограмма RtlGetOwnerSecurityDescriptor возвращает сведения о владельце для заданного дескриптора безопасности.

Синтаксис

NTSYSAPI NTSTATUS RtlGetOwnerSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Owner,
  [out] PBOOLEAN             OwnerDefaulted
);

Параметры

[in] SecurityDescriptor

Указатель на дескриптор безопасности.

[out] Owner

Указатель на адрес для получения указателя на идентификатор безопасности владельца (SID). Если дескриптор безопасности в настоящее время не содержит идентификатор безопасности владельца, владелец получает значение NULL.

[out] OwnerDefaulted

Указатель на логическую переменную, которая получает значение TRUE , если сведения о владельце являются производными от механизма по умолчанию, а не от исходного поставщика дескриптора безопасности явным образом; в противном случае — FALSE . Допустимо, только если владелец получает значение, отличное от NULL .

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

RtlGetOwnerSecurityDescriptor возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата	Описание
STATUS_UNKNOWN_REVISION	Уровень редакции дескриптора безопасности не известен или не поддерживается. Это код ошибки.

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

Требования

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