CeFindNextDatabaseEx (RAPI)

9/8/2008

Essa função recupera o próximo banco de dados em um contexto enumeração.

Syntax

CEOID CeFindNextDatabaseEx( 
  HANDLE hEnum,
  PCEGUID pceguid 
);

Parameters

• hEnum
  [no] Identificador retornado a partir CeFindFirstDatabaseEx.

• pceguid
  [no] Ponteiro para o CEGUID que contém a identificador exclusivo (GUID) de um banco de dados montado.

Return Value

Um válido CEOID indica sucesso. Zero indica falha ou falta de bancos de dados adicionais. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. Valores possíveis para CeGetLastError Incluir o seguinte:

• ERROR_NO_MORE_ITEMS
  Existem há mais bancos de dados para enumerar.

• ERROR_KEY_DELETED
  Um banco de dados foi excluído durante enumeração.

Remarks

Para localizar compatível todos os bancos de dados, CeFindNextDatabaseEx é chamado em um executar um loop até 0 é retornado. Se um banco de dados é excluído durante uma enumeração, CeFindNextDatabaseEx falha e retorna o erro ERROR_KEY_DELETED. Se esse erro ocorrer, você deve reiniciar a enumeração com um chamar para CeFindFirstDatabaseEx. Quando enumeração está completo, o hEnum identificador deve ser fechado, chamado de CeCloseHandle função.

Observação

Versões anteriores de Windows Embedded CE atribuído objeto identificadores a objetos em outros sistemas arquivo, such as o sistema de arquivos tabela de alocação de arquivos (FAT).Esses identificadores objeto foram garantia ser exclusivo em um volume, mas não entre múltiplo volumes.Eficaz com versão 3.0, apenas objetos em armazenar o objeto tiver válido, exclusivo objeto identificadores e armazenar o objeto é o único volume que pode retornar um objeto identificador.

Requirements

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions
CeFindFirstDatabaseEx (RAPI)