Compartilhar via


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

ZwCreateKey

ZwOpenKey