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

Статья
02/07/2025

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

Требования

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