SetSecurityDescriptorSacl 函式 (securitybaseapi.h)
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 |