RegEnumValue

9/8/2008

Essa função enumera os valores para o aberto especificado chave Registro. Esta função copia um Nome valor Indexado e bloco de dados para a chave cada tempo é chamado.

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

Syntax

LONG RegEnumValue( 
  HKEY hKey, 
  DWORD dwIndex, 
  LPWSTR lpValueName, 
  LPDWORD lpcchValueName, 
  LPDWORD lpReserved, 
  LPDWORD lpType, 
  LPBYTE lpData, 
  LPDWORD lpcbData 
); 

Parameters

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

  • HKEY_LOCAL_MACHINE
  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_USER
  • HKEY_USERS

  Os valores enumerados são associado com a chave identificado por esse parâmetro.

• dwIndex
  [no] O índice do valor para recuperar. Este parâmetro for definido como zero para o primeiro chamar para esta função e em seguida, ser incrementada para chamadas subseqüentes.

  Como valores não são ordenados, qualquer valor novo tem um índice arbitrário. Isso significa que a função retorna valores em qualquer ordem.

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

• lpcchValueName
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva apontado pelo lpValueName. Esse tamanho inclui o caractere nulo de terminação. Quando a função retornará, a variável apontada por esse parâmetro 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. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  REG_BINARY	Especifica dados binários em qualquer forma.
  REG_DWORD	Especifica um 32-bit número.
  REG_DWORD_BIG_ENDIAN	Especifica um 32-bit número no formato big-endian. No formato big-endian, um multibyte valor é armazenado na memória a partir de byte mais alto para o byte mais baixo. Exemplo, o valor 0x12345678 é armazenado como (0 x 12 0x34 0x78 0x56) no formato big-endian.
  REG_DWORD_LITTLE_ENDIAN	Especifica um 32-bit número no formato little-endian. Isso é equivalente para REG_DWORD. No formato little-endian, um multibyte valor é armazenado na memória a partir de byte mais baixa para o byte mais alto. Exemplo, o valor 0x12345678 é armazenado como (0x56 0x78 0x34 0 x 12) No formato little-endian.
  REG_EXPAND_SZ	Especifica um seqüência de caracteres NULL-Terminated que contém referências unexpanded para variáveis, de exemplo, ambiente % PATH %. Ele é um Unicode ou um seqüência ANSI, depending on se você usar as funções Unicode ou ANSI.
  REG_LINK	Especifica um link simbólico Unicode. Usado internamente. Aplicativos não usam esse tipo.
  REG_MULTI_SZ	Especifica uma matriz de seqüências de caracteres NULL-Terminated, finalizadas pelo NULL dois caracteres.
  REG_NONE	Nenhuma tipo de valor definido.
  REG_RESOURCE_LIST	Especifica um dispositivo-driver recurso lista.
  REG_SZ	Especifica um seqüência de caracteres Unicode NULL-Terminated.

  Este parâmetro pode ser definido como 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. Quando a função retornará, a variável apontada por esse parâmetro contém o número de bytes armazenados na reserva. Este parâmetro pode ser definido como NULL se apenas lpData é definido 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.

Remarks

Para enumerar os valores, um aplicativo chama essa função com inicialmente dwIndex definido como zero. O aplicativo e incrementos dwIndex e chama essa função até que não há mais valores. Isto é, até que a função retorna ERROR_NO_MORE_ITEMS.

O aplicativo também pode definir dwIndex Para o índice do último valor no primeiro chamar a função e diminuição de índice até o valor com índice zero é enumerada. Para recuperar o índice do último valor, use a função RegQueryInfoKey.

Ao usar essa função, um aplicativo não deve chamar as funções Registro que podem alteração a chave que está sendo enumerado.

Para verificar o tamanho máximo do nome e buffers de dados, use a função RegQueryInfoKey.

Requirements

See Also

Reference

Registry Functions
RegCreateKeyEx
RegEnumKeyEx
RegOpenKeyEx
RegQueryInfoKey

Other Resources

State and Notifications Broker