RegEnumKeyEx

9/8/2008

Essa função enumera subchaves o aberto especificado chave Registro. Essa função obtém informações sobre uma subchave cada tempo é chamado e ele obtém o nome classe da subchave e o tempo ela foi modificada pela última vez.

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

Syntax

LONG RegEnumKeyEx(
  HKEY hKey, 
  DWORD dwIndex, 
  LPWSTR lpName, 
  LPDWORD lpcName, 
  LPDWORD lpReserved, 
  LPWSTR lpClass, 
  LPDWORD lpcbClass, 
  PFILETIME lpftLastWriteTime 
); 

Parameters

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

  • HKEY_LOCAL_MACHINE
  • HKEY_CLASSES_ROOT
  • HKEY_CURRENT_USER
  • HKEY_USERS

  As chaves enumeradas são subchaves da chave identificados por esse parâmetro.

• dwIndex
  [no] O índice da subchave para recuperar. Este parâmetro for definido como zero para o primeiro chamar para o RegEnumKeyEx função e então incrementada para chamadas subseqüentes.

  Porque não são ordenados subchaves, qualquer nova subchave tem um índice arbitrário. Isso significa que essa função retorna subchaves em qualquer ordem.

• lpName
  [out] Ponteiro para uma reserva que recebe o nome da subchave, incluindo a caractere nulo de terminação. A função copia apenas o nome da subchave, não a chave completo hierarquia, para a reserva.

• lpcName
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva especificada por lpName. Esse tamanho inclui o caractere nulo de terminação. Quando essa função retorna, 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.

• lpClass
  [out] Ponteiro para uma reserva que contém a classe da subchave enumerado quando a função retorna. Este parâmetro pode ser definido como NULL se a classe não for exigido.

• lpcbClass
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva especificada por lpClass. O tamanho inclui o caractere nulo de terminação. Quando a função retorna, 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. Este parâmetro pode ser definido como NULL se apenas lpClass é definido como NULL.

• lpftLastWriteTime
  [no] Ignorado. Definir como NULL.

Return Value

ERROR_SUCCESS indica sucesso. Um valor de retorno de ERROR_MORE_DATA indica que o lpName reserva é muito pequena para receber o nome da chave. 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 subchaves, um aplicativo chama essa função com inicialmente dwIndex definido como zero. Um aplicativo e incrementos dwIndex e chamadas essa função até que não há mais subchaves, isto é, até que a função retorna ERROR_NO_MORE_ITEMS.

Um aplicativo também pode definir dwIndex Para o índice da subchave última sobre o primeiro chamar a esta função e diminuição de índice até a subchave com o índice zero é enumerada. Para recuperar o índice da subchave a última, use a função RegQueryInfoKey.

Enquanto um aplicativo está usando o RegEnumKeyEx função, ele deve não fazer chamadas para as funções Registro que talvez alteração a chave que está sendo enumerado. Use o RegCreateKeyEx ou o RegOpenKeyEx função para aberto a chave identificado por hKey.

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
RegCreateKeyEx
RegDeleteKey
RegOpenKeyEx
RegQueryInfoKey

Other Resources

State and Notifications Broker