Função SHDeleteEmptyKeyW (shlwapi.h)

Exclui uma chave vazia.

Sintaxe

LSTATUS SHDeleteEmptyKeyW(
  [in]           HKEY    hkey,
  [in, optional] LPCWSTR pszSubKey
);

Parâmetros

[in] hkey

Tipo: HKEY

Um identificador para uma chave do Registro aberta ou uma das seguintes chaves predefinidas:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszSubKey

Tipo: LPCTSTR

O endereço de uma cadeia de caracteres terminada em nulo especificando o nome da chave a ser excluída.

Valor retornado

Tipo: LSTATUS

Retorna ERROR_SUCCESS se tiver êxito ou um código de erro diferente de zero definido em Winerror.h caso contrário. Você pode usar a função FormatMessage com o sinalizador FORMAT_MESSAGE_FROM_SYSTEM para recuperar uma descrição genérica do erro.

Comentários

SHDeleteEmptyKey não excluirá uma chave se ela contiver subchaves ou valores. Em vez disso, use SHDeleteKey .

Como alternativa, use a função RegDeleteKey ou RegDeleteTree .

Observação

O cabeçalho shlwapi.h define SHDeleteEmptyKey como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 4.71 ou posterior)