RegQueryInfoKey

9/8/2008

Essa função recupera informações sobre uma chave Registro especificado.

Um remoto aplicativo versão interface (RAPI) dessa função existe chamado CeRegQueryInfoKey (RAPI).

Syntax

LONG RegQueryInfoKey( 
  HKEY hKey, 
  LPWSTR lpClass, 
  LPDWORD lpcbClass, 
  LPDWORD lpReserved, 
  LPDWORDlpcSubKeys, 
  LPDWORD lpcbMaxSubKeyLen, 
  LPDWORD lpcbMaxClassLen, 
  LPDWORD lpcValues, 
  LPDWORD lpcbMaxValueNameLen, 
  LPDWORD lpcbMaxValueLen, 
  LPDWORD lpcbSecurityDescriptor, 
  PFILETIME lpftLastWriteTime 
); 

Parameters

• hKey
  [no] Identificador para um atualmente aberto identificador reservado valores predefinidos chave ou de qualquer o seguinte:

  • HKEY_LOCAL_MACHINE
  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_USER
  • HKEY_USERS

• lpClass
  [out] Ponteiro para uma reserva que recebe classe nome a chave. Este parâmetro pode ser definido como NULL.

• lpcbClass
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva apontado pelo lpClass. Esse tamanho inclui o caractere nulo de terminação. Quando a função retorna, essa variável contém o comprimento do seqüência de caracteres a classe armazenados na reserva. A contagem retornada não inclui o caractere nulo de terminação. Se a reserva não for grande o suficiente, a função retorna ERROR_MORE_DATA e a variável contém o tamanho do seqüência de caracteres, em caracteres, sem contagem de NULL caractere.

  Se lpClass é definido como NULL, lpcbClass Pode ser definido como NULL.

  Se lpClass é um válido endereço, mas este parâmetro não for, a função retornará ERROR_INVALID_PARAMETER.

• lpReserved
  [no] Reservado. Definir como NULL.

• lpcSubKeys
  [out] Ponteiro para uma variável que recebe o número de subchaves contidos pela chave especificada. Este parâmetro pode ser definido como NULL.

• lpcbMaxSubKeyLen
  [out] Ponteiro para uma variável que recebe o comprimento, em caracteres, da subchave da chave com o nome mais longo. A contagem retornada não inclui o caractere nulo de terminação. Este parâmetro pode ser definido como NULL.

• lpcbMaxClassLen
  [out] Ponteiro para uma variável que recebe o comprimento, em caracteres, da seqüência de caracteres mais longa especificando uma subchave classe. A contagem retornada não inclui o caractere nulo de terminação. Este parâmetro pode ser definido como NULL.

• lpcValues
  [out] Ponteiro para uma variável que recebe o número de valores associado com a chave. Este parâmetro pode ser definido como NULL.

• lpcbMaxValueNameLen
  [out] Ponteiro para uma variável que recebe o comprimento, em caracteres, do nome valor mais longa a chave. A contagem retornada não inclui o caractere nulo de terminação. Este parâmetro pode ser definido como NULL.

• lpcbMaxValueLen
  [out] Ponteiro para uma variável que recebe o comprimento, em bytes, da mais longa componente dados entre os valores de chave. Este parâmetro pode ser definido como NULL.

• lpcbSecurityDescriptor
  [no] Não usado. Definir como NULL.

• lpftLastWriteTime
  [no] Ignorado. Definir como NULL.

Return Value

ERROR_SUCCESS indica sucesso. Um diferente de zero código de erro definidos no Winerror.h indica falha. Para get um genérico descrição do erro, chamar a função FormatMessage com o conjunto sinalizador FORMAT_MESSAGE_FROM_SYSTEM. O recurso mensagem é opcional, caso FormatMessage pode falhar.

Requirements

Header	winreg.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Registry Functions
RegDeleteKey
RegEnumKeyEx
RegEnumValue
RegQueryValueEx

Other Resources

State and Notifications Broker