RtlGetOwnerSecurityDescriptor 函数 (ntifs.h)

项目
02/26/2024

RtlGetOwnerSecurityDescriptor 例程返回给定安全描述符的所有者信息。

语法

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

参数

[in] SecurityDescriptor

指向安全描述符的指针。

[out] Owner

指向地址的指针，用于接收指向 SID) 所有者安全标识符 (指针。如果安全描述符当前不包含所有者 SID， 则所有者 会收到 NULL。

[out] OwnerDefaulted

指向布尔变量的指针，如果所有者信息派生自默认机制，而不是由安全描述符的原始提供程序显式派生，则接收 TRUE ，否则 为 FALSE 。仅当 所有者 收到非 NULL 值时有效。

返回值

RtlGetOwnerSecurityDescriptor 返回STATUS_SUCCESS或相应的 NTSTATUS 值，如以下值之一：

返回代码	说明
STATUS_UNKNOWN_REVISION	安全描述符的修订级别未知或不受支持。这是错误代码。

注解

有关安全性和访问控制的详细信息，请参阅面向驱动程序开发人员的 Windows 安全模型和 Windows SDK 中有关这些主题的文档。

要求

要求	值
最低受支持的客户端	Windows 2000
目标平台	通用
标头	ntifs.h (包括 Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL	PASSIVE_LEVEL