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 o ACE a ser excluído. Um valor zero corresponde ao primeiro ACE na ACL, 1 ao segundo ACE e assim por diante.
Valor de retorno
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 do índice especificado está fora do intervalo.
- STATUS_INVALID_PARAMETER é um código de erro.
Observações
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 um 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 |
|---|---|
| de cliente com suporte mínimo | Windows Server 2003 SP1 |
| da Plataforma de Destino | Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |