SetSecurityDescriptorSacl 函式 (securitybaseapi.h)

發行項
03/05/2024

SetSecurityDescriptorSacl 函式會設定系統訪問控制清單中的資訊， (SACL) 。如果安全性描述項中已經有 SACL，則會加以取代。

語法

BOOL SetSecurityDescriptorSacl(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]           BOOL                 bSaclPresent,
  [in, optional] PACL                 pSacl,
  [in]           BOOL                 bSaclDefaulted
);

參數

[in, out] pSecurityDescriptor

函式在其中加入 SACL 之SECURITY_DESCRIPTOR 結構的指標。這個安全性描述元必須是絕對格式，這表示其成員必須是其他結構的指標，而不是連續數據的位移。

[in] bSaclPresent

指出安全性描述項中是否有 SACL。如果此參數為 TRUE，函式會在 SECURITY_DESCRIPTOR_CONTROL 結構中設定 SE_SACL_PRESENT 旗標，並使用 pSacl 和 bSaclDefaulted 參數中的值。如果為 FALSE，函式不會設定SE_SACL_PRESENT旗標，而且會忽略 pSacl 和 bSaclDefaulted。

[in, optional] pSacl

ACL 結構的指標，指定安全描述元的 SACL。如果此參數為 NULL，則會將 NULL SACL 指派給安全性描述項。 SACL 是由安全性描述元所參考，而不是複製到中。

[in] bSaclDefaulted

表示 SACL 的來源。如果此旗標為 TRUE，則 SACL 已由某些預設機制擷取。如果為 FALSE，則 SACL 已由使用者明確指定。函式會將此值儲存在 SECURITY_DESCRIPTOR_CONTROL結構的SE_SACL_DEFAULTED 旗標中。如果未指定此參數，則會清除SE_SACL_DEFAULTED旗標。

傳回值

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

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

規格需求

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