CeRegEnumKeyEx (RAPI)

9/8/2008

Essa função enumera subchaves de um aberto chave Registro em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

LONG CeRegEnumKeyEx(
  HKEY hKey, 
  DWORD dwIndex, 
  LPWSTR lpName, 
  LPDWORD lpcbName, 
  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_CLASSES_ROOT

  HKEY_CURRENT_USER

  HKEY_LOCAL_MACHINE

  HKEY_USERS

  As chaves enumeradas são subchaves da chave identificado por hKey.

• dwIndex
  [no] Especifica o índice da subchave para recuperar. Este parâmetro deve ser zero para o primeiro chamar para o CeRegEnumKeyEx função e, em seguida, incrementada para chamadas subseqüentes.

  Porque não são ordenados subchaves, qualquer nova subchave terá um índice arbitrário. Isso significa que a função pode retornar 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.

• lpcbName
  [in, Out] Ponteiro para uma variável que especifica o tamanho, em caracteres, da reserva especificada pelo lpName parâmetro. Esse tamanho deve incluir a caractere nulo de terminação. Quando a função retornará, a variável apontada pelo lpcbName 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 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 pelo lpClass parâmetro. O tamanho deve incluir a caractere nulo de terminação. Quando a função retorna, lpcbClass 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 NULL somente se lpClass é NULL.

• lpftLastWriteTime
  [no] Ignorada; 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 FormatMessage Com o conjunto sinalizador FORMAT_MESSAGE_FROM_SYSTEM. O recurso mensagem é opcional, portanto, se você chamar FormatMessage Ele poderia falhar.

Remarks

Para Enumerar subchaves, um aplicativo deve inicialmente chamar o CeRegEnumKeyEx função com o dwIndex parâmetro definido como zero. Um aplicativo deve, em seguida, incremento de dwIndex parâmetro e chamar CeRegEnumKeyEx Até que não há mais subchaves (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.

Enquanto um aplicativo está usando o CeRegEnumKeyEx função, ele deve não fazer chamadas para funções qualquer registro que podem alteração a chave que está sendo enumerado.

A chave identificado por hKey Deve ter sido aberto com acessar KEY_ENUMERATE_SUB_KEYS (KEY_READ inclui KEY_ENUMERATE_SUB_KEYS). Use o CeRegCreateKeyEx Ou CeRegOpenKeyEx função para a chave aberto.

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