(securitybaseapi.h) SetSecurityDescriptorOwner 函式

發行項
08/25/2023

SetSecurityDescriptorOwner 函式會設定絕對格式安全性描述元的擁有者資訊。它會取代安全性描述項中已存在的任何擁有者資訊。

語法

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

參數

[in, out] pSecurityDescriptor

SECURITY_DESCRIPTOR結構的指標，其擁有者是由這個函式所設定。函式會將任何現有的擁有者取代為新的擁有者。

[in, optional] pOwner

安全性描述項新主要擁有者的 SID 結構的指標。 SID結構是由安全性描述項所參考，而不是複製到中。如果此參數為 Null，函式會清除安全性描述項的擁有者資訊。這會將安全性描述項標示為沒有擁有者。

[in] bOwnerDefaulted

指出擁有者資訊是否衍生自預設機制。如果此值為 TRUE，則為預設資訊。函式會將此值儲存為SECURITY_DESCRIPTOR_CONTROL結構中的 SE_OWNER_DEFAULTED 旗標。如果此參數為零，則會清除SE_OWNER_DEFAULTED旗標。

傳回值

如果函式成功，則傳回非零的值。

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

需求


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