Funzione RtlDeleteAce (ntifs.h)
La routine RtlDeleteAce elimina una voce di controllo di accesso (ACE) da un elenco di controllo di accesso specificato (ACL).
Sintassi
NTSYSAPI NTSTATUS RtlDeleteAce(
[in, out] PACL Acl,
[in] ULONG AceIndex
);
Parametri
[in, out] Acl
Puntatore all'elenco di controllo di controllo di accesso da modificare. RtlDeleteAce elimina l'ACE specificato da questo ACL.
[in] AceIndex
Specifica l'ace da eliminare. Un valore pari a zero corrisponde al primo ACE nell'ACL, 1 al secondo ACE e così via.
Valore restituito
RtlDeleteAce restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Uno dei valori dei parametri non è valido. |
I possibili motivi per STATUS_INVALID_PARAMETER includono:
- L'ACL specificato non è valido.
- Il valore di indice specificato non è compreso nell'intervallo.
- STATUS_INVALID_PARAMETER è un codice di errore.
Commenti
Per informazioni sul calcolo delle dimensioni di un ACL, vedere la sezione Osservazioni della voce di riferimento per RtlCreateAcl.
Per aggiungere un ACE a un ACL, usare RtlAddAce.
Per ottenere un puntatore a un ace in un ACL, usare RtlGetAce.
Per altre informazioni sul controllo di sicurezza e accesso, vedere Modello di sicurezza di Windows per sviluppatori driver e la documentazione su questi argomenti in Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Server 2003 SP1 |
| Piattaforma di destinazione | Universale |
| Intestazione | ntifs.h (include Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |