共用方式為


(securitybaseapi.h) SetSecurityDescriptorOwner 函式

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

另請參閱

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

低階存取控制

低階存取控制函式

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorSacl