DeleteAce 函式 (securitybaseapi.h)

DeleteAce 函式會從訪問控制清單 (ACL) 中移除存取控制專案 (ACE) 。

語法

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

[in, out] pAcl

ACL 的指標。 dwAceIndex 參數指定的 ACE 會從這個 ACL 中移除。

[in] dwAceIndex

要刪除的 ACE。值為零會對應至 ACL 中的第一個 ACE、一個到第二個 ACE 的值，依此類推。

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

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

應用程式可以使用 GetAclInformation 函式所擷取的ACL_SIZE_INFORMATION結構來探索 ACL 的大小及其包含的 ACE 數目。 GetAce 函式會擷取個別 ACE 的相關信息。

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