Funzione DeleteAce (securitybaseapi.h)

Articolo
03/01/2024

La funzione DeleteAce elimina una voce di controllo di accesso (ACE) da un elenco di controllo di accesso (ACL).

Sintassi

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

Parametri

[in, out] pAcl

Puntatore a un elenco di controllo di accesso. L'ace specificato dal parametro dwAceIndex viene rimosso da questo elenco di controllo di accesso.

[in] dwAceIndex

Ace da eliminare. Un valore pari a zero corrisponde al primo ACE nell'ACL, un valore compreso tra uno e il secondo ACE e così via.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un'applicazione può usare la struttura ACL_SIZE_INFORMATION recuperata dalla funzione GetAclInformation per individuare le dimensioni dell'ACL e il numero di ACL che contiene. La funzione GetAce recupera informazioni su un singolo ace.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll