Função ZwDeleteKey (wdm.h)
A rotina ZwDeleteKey exclui uma chave aberta do registro.
Sintaxe
NTSYSAPI NTSTATUS ZwDeleteKey(
[in] HANDLE KeyHandle
);
Parâmetros
[in] KeyHandle
Manipule para a chave do Registro a ser excluída. O identificador é criado por uma chamada bem-sucedida para ZwCreateKey ou ZwOpenKey.
Retornar valor
ZwDeleteKey retorna um valor NTSTATUS. Os possíveis valores retornados incluem:
STATUS_SUCCESS
STATUS_ACCESS_DENIED
STATUS_INVALID_HANDLE
STATUS_CANNOT_DELETE (consulte Comentários)
Comentários
Antes de chamar ZwDeleteKey, verifique se todas as chaves e valores sob a chave fornecida foram excluídos. Exclua cada subchave primeiro, começando com as teclas folha e trabalhe seu caminho para cima.
O identificador deve ter sido aberto para que o acesso DELETE para que essa rotina tenha êxito. Para obter mais informações, consulte o parâmetro DesiredAccess para ZwCreateKey.
Uma chamada para ZwDeleteKey faz com que o identificador especificado no parâmetro KeyHandle e todos os outros identificadores para a chave excluída se torne inválido. Depois que uma chamada para ZwDeleteKey invalida os identificadores de chave, você deve chamar ZwClose para fechar os identificadores de chave.
Para obter mais informações sobre como trabalhar com chaves do Registro, consulte Usando o Registro em um Driver.
Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtDeleteKey" em vez de "ZwDeleteKey".
Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regras de conformidade de DDI | HwStorPortProhibitedDDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm) |
Confira também
Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo