CeRegEnumValue (RAPI)

9/8/2008

Essa função enumera os valores para o aberto especificado chave Registro em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

LONG CeRegEnumValue( 
  HKEY hKey, 
  DWORD dwIndex, 
  LPWSTR lpszValueName, 
  LPDWORD lpcbValueName, 
  LPDWORD lpReserved, 
  LPDWORD lpType, 
  LPBYTE lpData, 
  LPDWORD lpcbData 
);

Parameters

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

  HKEY_CLASSES_ROOT

  HKEY_CURRENT_USER

  HKEY_LOCAL_MACHINE

  HKEY_USERS

  Os valores enumerados são associado com a chave identificado por hKey.

• dwIndex
  [no] Especifica o índice do valor para recuperar. Este parâmetro deve ser zero para o primeiro chamar para o CeRegEnumValue função e, em seguida, ser incrementada para chamadas subseqüentes. Porque os valores não são ordenados, qualquer valor novo terá um índice arbitrário. Isso significa que a função pode retornar valores em qualquer ordem.

• lpszValueName
  [out] Ponteiro para uma reserva que recebe o nome do valor, incluindo a caractere nulo de terminação.

• lpcbValueName
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva apontado pelo lpValueName parâmetro. Esse tamanho deve incluir a caractere nulo de terminação. Quando a função retornará, a variável apontada pelo lpcbValueName Contém o número de caracteres armazenados na reserva. A contagem retornada não inclui o caractere nulo de terminação.

• lpReserved
  [no] Reservado; Definir como NULL.

• lpType
  [out] Ponteiro para uma variável que recebe a codificar tipo para a entrada valor. Codificar o tipo pode ser uma do seguinte valores.

  Valor	Descrição
  REG_BINARY	Especifica dados binários em qualquer forma.
  REG_DWORD	Especifica um 32-bit número.
  REG_DWORD_LITTLE_ENDIAN	Especifica 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	Especifica 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	Specifies a null-terminated wide character string that contains unexpanded references to environment variables (for example, %PATH%).A null-terminated string that contains unexpanded references to environment variables (for example, "%PATH%").
  REG_LINK	Especifica um link simbólico A Unicode. Usada internamente; aplicativos não devem usar este tipo.
  REG_MULTI_SZ	Especifica uma matriz uma das seqüências NULL-Terminated, finalizadas pelo NULL dois caracteres.
  REG_NONE	Não especifica nenhum tipo de valor definido.
  REG_RESOURCE_LIST	Especifica um dispositivo de-driver recurso lista.
  REG_SZ	Especifica um seqüência de caracteres stringnull-Terminated caractere largo NULL-Terminated A.

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

• lpData
  [out] Ponteiro para uma reserva que recebe os dados para entrada de 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 retornará, a variável apontado pelo lpcbData parâmetro contém o número de bytes armazenados na reserva. Este parâmetro pode ser NULL, somente se lpData é 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. O recurso mensagem é opcional; Portanto, se você chamar FormatMessage Ele poderia falhar.

Remarks

Para enumerar os valores, um aplicativo deve inicialmente chamar o CeRegEnumValue função com o dwIndex parâmetro definido como zero. O aplicativo deve, em seguida, incremento dwIndex e chamar o CeRegEnumValue função até que não há mais valores (até que a função retorna ERROR_NO_MORE_ITEMS).

Para recuperar o número de subchaves para uma determinada chave, use o CeRegQueryInfoKey função.

Ao usar CeRegEnumValue, um aplicativo não deve chamar funções qualquer registro que podem alteração a chave que está sendo consultado.

A chave identificado pelo hKey parâmetro deve ter sido aberto com acessar KEY_QUERY_VALUE. Para aberto a chave, use o CeRegCreateKeyEx Ou CeRegOpenKeyEx função.

Para determinar o tamanho máximo do nome e buffers de dados, use o CeRegQueryInfoKey função.

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