Funzione RtlDeleteAce (ntifs.h)

  • Articolo

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

Vedi anche

ACE

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce