RtlGetOwnerSecurityDescriptor 函数 (ntifs.h)

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

另请参阅

RtlCreateSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlSetOwnerSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR

SID