GetSecurityDescriptorSacl 函式 (securitybaseapi.h)

發行項
03/01/2024

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