Compartilhar via


Método IRegistryKey::D eleteKey (portcls.h)

O DeleteKey método exclui a chave do Registro.

Sintaxe

NTSTATUS DeleteKey();

Retornar valor

DeleteKey retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.

Comentários

Um chamador exclui a chave do Registro de um objeto IRegistryKey chamando o DeleteKey método nesse objeto. A chave só poderá ser excluída se o chamador tiver criado a chave com um ACCESS_MASK que permita a exclusão. O chamador habilita a exclusão especificando um valor de parâmetro DesiredAccess de KEY_ALL_ACCESS (descrito em ZwCreateKey) para a chamada PcNewRegistryKey, IPort::NewRegistryKey ou IRegistryKey::NewSubKey que cria a chave. Ao excluir uma chave, o objeto IRegistryKey descarta seu identificador de chave de registro e todos os outros identificadores para a chave excluída tornam-se inválidos.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho portcls.h (inclua Portcls.h)
IRQL PASSIVE_LEVEL

Confira também

ACCESS_MASK

IPort::NewRegistryKey

IRegistryKey

IRegistryKey::NewSubKey

PcNewRegistryKey

ZwCreateKey

ZwDeleteKey