Função SHQueryInfoKeyA (shlwapi.h)

  • Artigo

Recupera informações sobre uma chave do Registro especificada.

Sintaxe

LSTATUS SHQueryInfoKeyA(
  [in]            HKEY    hkey,
  [out, optional] LPDWORD pcSubKeys,
  [out, optional] LPDWORD pcchMaxSubKeyLen,
  [out, optional] LPDWORD pcValues,
  [out, optional] LPDWORD pcchMaxValueNameLen
);

Parâmetros

[in] hkey

Tipo: HKEY

Um identificador para a chave aberta no momento ou qualquer um dos valores predefinidos a seguir.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[out, optional] pcSubKeys

Tipo: LPDWORD

O endereço de um DWORD que recebe o número de subchaves sob a chave especificada.

[out, optional] pcchMaxSubKeyLen

Tipo: LPDWORD

O endereço de um DWORD que recebe o número de caracteres no nome da subchave com o maior nome.

[out, optional] pcValues

Tipo: LPDWORD

O endereço de um DWORD que recebe o número de valores sob a chave especificada.

[out, optional] pcchMaxValueNameLen

Tipo: LPDWORD

O endereço de um DWORD que recebe o número de caracteres no nome do valor com o maior nome.

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 textual do erro.

Comentários

Observação

O cabeçalho shlwapi.h define SHQueryInfoKey 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)