共用方式為


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

另請參閱

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

InitializeSecurityDescriptor

IsValidSecurityDescriptor

低階 存取控制

低階 存取控制 函式

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorSacl