GetSecurityDescriptorSacl 函式 (securitybaseapi.h)
GetSecurityDescriptorSacl 函式會擷取系統訪問控制清單的指標, (指定之安全性描述元中的 SACL) 。
語法
BOOL GetSecurityDescriptorSacl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] LPBOOL lpbSaclPresent,
[out] PACL *pSacl,
[out] LPBOOL lpbSaclDefaulted
);
參數
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR 結構的指標,其中包含函式擷取指標的 SACL。
[out] lpbSaclPresent
函式設定旗標的指標,表示指定之安全性描述項中是否有 SACL。 如果此參數為 TRUE,安全性描述元會包含 SACL,而且此函式中的其餘輸出參數會收到有效的值。 如果此參數為 FALSE,則安全性描述元不包含 SACL,而其餘的輸出參數則不會接收有效值。
[out] pSacl
指向訪問控制清單指標的指標, (ACL) 。 如果 SACL 存在,函式會將 pSacl 指向的指標設定為安全描述項 SACL 的位址。 如果 SACL 不存在,則不會儲存任何值。
如果函式將 NULL 值儲存在 pSacl 指向的指標中,則安全性描述項會有 NULL SACL。
[out] lpbSaclDefaulted
如果安全性描述項有 SACL 存在,則旗標的指標會設定為SECURITY_DESCRIPTOR_CONTROL結構中 SE_SACL_DEFAULTED 旗標的值。
傳回值
如果函式成功,函式會傳回非零。
如果函式失敗,則會傳回零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | securitybaseapi.h (包含 Windows.h) |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |