CeRegQueryValueEx (RAPI)

9/8/2008

Essa função recupera o tipo e dados para um nome especificado valor associado com um aberto chave Registro em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

LONG CeRegQueryValueEx( 
  HKEY hKey, 
  LPCWSTR lpValueName, 
  LPDWORD lpReserved, 
  LPDWORD lpType, 
  LPBYTE lpData, 
  LPDWORD lpcbData 
);

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

• lpValueName
  [no] Ponteiro para uma seqüência de caracteres que contém o nome do valor para consulta. Se este parâmetro é NULL ou um seqüência vazia, a função recupera o tipo e dados para sem nome a chave valor. Uma chave Registro não automaticamente têm um sem nome ou usar como padrão valor. Valores sem nome podem ser de qualquer tipo.

• lpReserved
  [no] Reservado; Definir como NULL.

• lpType
  [out] Ponteiro para uma variável que recebe o tipo de dados associado com o valor especificado. A seguinte tabela mostra os valores possíveis que lpType Pode returnThe valor retornado por esse parâmetro será um do seguinte.

  Valor	Descrição
  REG_BINARY	Dados binários em qualquer forma.
  REG_DWORD	Um 32-bit número.
  REG_DWORD_LITTLE_ENDIAN	Um 32-bit número no formato little-endian. Isso é equivalente para REG_DWORD. No formato little-endian, um valor de múltiplos bytes é armazenada na memória a partir de byte mais baixo (o " fim pouco") para o byte mais alto. Exemplo, o valor 0x12345678 é armazenado como (0x56 0x78 0x34 0 x 12) no formato little-endian.
  REG_DWORD_BIG_ENDIAN	Um 32-bit número no formato big-endian. No formato big-endian, um valor de múltiplos bytes é armazenada na memória a partir de byte mais alto (o " big end") para o byte mais baixo. Exemplo, o valor 0x12345678 é armazenado como (0 x 12 0x34 0x78 0x56) no formato big-endian.
  REG_EXPAND_SZ	Um seqüência de caracteres NULL-Terminated que contém referências unexpanded a variáveis ambiente (por exemplo, "% path %").
  REG_LINK	Um link simbólico Unicode. Usada internamente; aplicativos não devem usar este tipo.
  REG_MULTI_SZ	Uma matriz de seqüências de caracteres NULL-Terminated, finalizado pelo NULL dois caracteres.
  REG_NONE	Nenhuma tipo de valor definido.
  REG_RESOURCE_LIST	Um dispositivo-driver recurso lista.
  REG_SZ	Um seqüência de caracteres NULL-Terminated.

  O lpType parâmetro pode ser NULL se não for o tipo exigido.

• lpData
  [out] Ponteiro para uma reserva que recebe dados do valor. Este parâmetro pode ser NULL se os dados não for exigido.

• lpcbData
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em bytes, da reserva apontado pelo lpData parâmetro. Quando a função retorna, essa variável contém o tamanho dos dados copiados para lpData.

  • Se a dados tem o tipo REG_SZ, REG_MULTI_SZ ou REG_EXPAND_SZ, em seguida, lpcbData também incluirá o tamanho da caractere nulo de terminação.
  • O lpcbData parâmetro pode ser NULL somente se lpData é NULL.
  • Se a reserva fornecido na lpData parâmetro não é grande o suficiente para armazenar os dados, a função retornará o valor ERROR_MORE_DATA e armazena o exigido tamanho do buffer, em bytes, para a variável apontado pelo lpcbData.
  • Se lpData é NULL, e lpcbData não-NULL, a função retorna ERROR_SUCCESS e armazena o tamanho dos dados, em bytes, da variável apontado pelo lpcbData. Isso permite que um aplicativo determinar a melhor maneira alocar uma reserva para dados do valor.

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 por hKey Deve ter sido aberto com acessar KEY_QUERY_VALUE. Para aberto a chave, use o CeRegCreateKeyEx Ou CeRegOpenKeyEx função.

Windows Embedded CE oferece suporte apenas para a versão Unicode desta função.

Observação

For Windows Mobile: Em Dispositivos execução Windows Mobile 2003 Second Edition, se a reserva fornecido na lpData parâmetro não é grande o suficiente para armazenar os dados retornados, o exigido tamanho do buffer não é retornado na lpcbData parâmetro e a função retorna o código de erro 0 x 80004005.

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
CeRegCreateKeyEx (RAPI)
CeRegEnumKeyEx (RAPI)
CeRegEnumValue (RAPI)
CeRegOpenKeyEx (RAPI)
CeRegQueryInfoKey (RAPI)