CeFindFirstDatabaseEx (CEDB)

9/8/2008

Essa função abre um contexto enumeração para todos os bancos de dados em um volume banco de dados.

Essa função não trabalho com bancos de dados Edb. Para obter mais informações, consulte EDB Functions.

Uma versão RAPI dessa função existe nomeado CeFindFirstDatabaseEx (RAPI).

Syntax

HANDLE CeFindFirstDatabaseEx( 
  PCEGUID pceguid, 
  DWORD dwDbaseType
);

Parameters

• pceguid
  [no] Ponteiro para o CEGUID que contém o Identificador global exclusivo identifierof um volume montado banco de dados. Se pceguid aponta para o sistema valor GUID, armazenar o objeto é usado como o volume banco de dados. Se pceguid é NULL ou definido para um inválido GUID, todos montado banco de dados volumes são pesquisados.

• dwDbaseType
  [no] Digite identificador dos bancos de dados para enumerar. Se este parâmetro for definido para zero, todos os bancos de dados são enumerados no volume. Para dispositivos baseado em Windows Embedded CE, um volume é armazenar o objeto ou um volume montado banco de dados.

Return Value

Um identificador para um contexto enumeração indica sucesso. INVALID_HANDLE_VALUE indica falha. Para informações de erro estendidas get, chamar GetLastError. GetLastError pode retornar ERROR_OUTOFMEMORY se há memória disponível para alocar um identificador contexto enumeração.

Remarks

Essa função retorna somente o identificador para um contexto enumeração. Para começar a enumeração bancos de dados, chamar a função CeFindNextDatabaseEx (CEDB). Quando um aplicativo for concluído com o identificador para o contexto enumeração, use a função CloseHandle a versão de recursos associado com o contexto enumeração. Para localizar os bancos de dados o tipo desejado, especificar o identificador contexto enumeração em múltiplo chama para CeFindNextDatabaseEx (CEDB).

Você pode criar um sistema usando a macro CREATE_SYSTEMGUID GUID, e você pode criar um inválido GUID usando a macro CREATE_INVALIDGUID.

Requirements

Header	windbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 2.10 and later

See Also

Reference

CEDB Functions
CeFindNextDatabaseEx (CEDB)
CloseHandle
CREATE_SYSTEMGUID
CREATE_INVALIDGUID