getSecurityDescriptorOwner 函式 (securitybaseapi.h)

發行項
03/01/2024

GetSecurityDescriptorOwner 函式會從安全性描述項擷取擁有者資訊。

語法

BOOL GetSecurityDescriptorOwner(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pOwner,
  [out] LPBOOL               lpbOwnerDefaulted
);

參數

[in] pSecurityDescriptor

函式所擷取其擁有者資訊的SECURITY_DESCRIPTOR結構的指標。

[out] pOwner

安全性標識符指標的指標 (SID) ，可在函式傳回時識別擁有者。如果安全性描述項不包含擁有者，函式會將 pOwner 指向的指標設定為 NULL ，並忽略其餘的輸出參數 lpbOwnerDefaulted。如果安全性描述項包含擁有者，函式會將 pOwner 指向的指標設定為安全描述項擁有者 SID 的位址，併為 lpbOwnerDefaulted 所指向的變數提供有效值。

[out] lpbOwnerDefaulted

旗標的指標，設定為函式傳回時SECURITY_DESCRIPTOR_CONTROL結構中 SE_OWNER_DEFAULTED 旗標的值。如果 pOwner 參數指向的變數中所儲存的值是 NULL，則不會設定任何值。

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，則會傳回零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll