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 |