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
);
Parâmetros
[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.
Retornar valor
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:
- A ACL especificada é inválida.
- O valor de índice especificado está fora do intervalo.
- STATUS_INVALID_PARAMETER é um código de erro.
Comentários
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Server 2003 SP1 |
| Plataforma de Destino | Universal |
| Cabeçalho | ntifs.h (inclua Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |