(ntifs.h) RtlGetOwnerSecurityDescriptor 函式

發行項
02/29/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 。只有在 Owner 收到非 NULL 值時才有效。

傳回值

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

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

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 2000
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL	PASSIVE_LEVEL