Função SHRegQueryInfoUSKeyA (shlwapi.h)

Recupera informações sobre uma subchave do Registro especificada em uma subárvore específica do usuário (HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE).

Sintaxe

LSTATUS SHRegQueryInfoUSKeyA(
  [in]            HUSKEY          hUSKey,
  [out, optional] LPDWORD         pcSubKeys,
  [out, optional] LPDWORD         pcchMaxSubKeyLen,
  [out, optional] LPDWORD         pcValues,
  [out, optional] LPDWORD         pcchMaxValueNameLen,
  [in]            SHREGENUM_FLAGS enumRegFlags
);

Parâmetros

[in] hUSKey

Tipo: HUSKEY

Um identificador para uma subchave do Registro aberta no momento. A subchave deve ter sido aberta com o direito de acesso KEY_SET_VALUE. Para obter mais informações, consulte Segurança de Chave do Registro e Direitos de Acesso.

Esse identificador pode ser obtido por meio da função SHRegOpenUSKey .

[out, optional] pcSubKeys

Tipo: LPDWORD

Um ponteiro para um DWORD que recebe o número de subchaves sob a chave especificada.

[out, optional] pcchMaxSubKeyLen

Tipo: LPDWORD

Um ponteiro para um DWORD que recebe o número de caracteres no maior nome de subchave.

[out, optional] pcValues

Tipo: LPDWORD

Um ponteiro para um DWORD que recebe o número de valores sob a chave especificada.

[out, optional] pcchMaxValueNameLen

Tipo: LPDWORD

Um ponteiro para um DWORD que recebe o número de caracteres no nome do maior valor.

[in] enumRegFlags

Tipo: SHREGENUM_FLAGS

Um dos SHREGENUM_FLAGS que especifica a chave base na qual a consulta deve ocorrer.

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 SHRegQueryInfoUSKey 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)