Função RtlDeleteAce (ntifs.h)

A rotina RtlDeleteAce exclui uma ACE (entrada de controle de acesso) de uma ACL (lista de controle de acesso) especificada.

Sintaxe

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);

[in, out] Acl

Ponteiro para a ACL a ser modificada. RtlDeleteAce exclui o ACE especificado dessa ACL.

[in] AceIndex

Especifica a ACE a ser excluída. Um valor zero corresponde ao primeiro ACE na ACL, 1 ao segundo ACE e assim por diante.

RtlDeleteAce retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_INVALID_PARAMETER	Um dos valores de parâmetro era inválido.

Os possíveis motivos para STATUS_INVALID_PARAMETER incluem:

Para obter informações sobre como calcular o tamanho de uma ACL, consulte a seção Comentários da entrada de referência para RtlCreateAcl.

Para adicionar uma ACE a uma ACL, use RtlAddAce.

Para obter um ponteiro para um ACE em uma ACL, use RtlGetAce.

Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.