CeRegQueryInfoKey (RAPI)

9/8/2008

Essa função recupera informações sobre uma chave Registro especificado em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

LONG CeRegQueryInfoKey( 
  HKEY hKey, 
  LPWSTR lpClass, 
  LPDWORD lpcbClass, 
  LPDWORD lpReserved, 
  LPDWORD lpcSubKeys, 
  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_CLASSES_ROOT

  HKEY_CURRENT_USER

  HKEY_LOCAL_MACHINE

  HKEY_USERS

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

• lpcbClass
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva apontado pelo lpClass parâmetro. Esse tamanho deve incluir a 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 é 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 é NULL, lpcbClass pode ser NULL.
  • Se o parâmetro 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 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 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 NULL.

• lpcValues
  [out] Ponteiro para uma variável que recebe o número de valores associado com a chave. Este parâmetro pode ser 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 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 NULL.

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

• lpftLastWriteTime
  [no] Ignorada; 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 FormatMessage Com o conjunto sinalizador FORMAT_MESSAGE_FROM_SYSTEM.

Remarks

A chave identificado pelo hKey parâmetro deve ter sido aberto com acessar KEY_QUERY_VALUE (KEY_READ acessar inclui acessar KEY_QUERY_VALUE).

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions
CeRegDeleteKey (RAPI)
CeRegEnumKeyEx (RAPI)
CeRegEnumValue (RAPI)
CeRegQueryValueEx (RAPI)