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）。如果安全性描述元目前未包含擁有者 SID，擁有者 會收到 NULL。

[out] OwnerDefaulted

如果擁有者資訊衍生自默認機制，而不是由安全性描述元的原始提供者明確衍生，則為 Boolean 變數的指標，FALSE 否則為 TRUE。只有當 擁有者 收到非NULL 值時，才有效。

傳回值

RtlGetOwnerSecurityDescriptor 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	描述
STATUS_UNKNOWN_REVISION	安全性描述項的修訂層級未知或不受支援。這是錯誤碼。

言論

如需安全性和訪問控制的詳細資訊，請參閱適用於驅動程式開發人員的 Windows 安全性模型，以及 Windows SDK 中這些主題的檔。

要求

要求	價值
最低支援的用戶端	Windows 2000
目標平臺	普遍
標頭	ntifs.h （include Ntifs.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe （核心模式）：Ntdll.dll （使用者模式）
IRQL	PASSIVE_LEVEL