Compartilhar via


CeFindFirstDatabaseEx (RAPI)

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função abre um contexto enumeração para todos os bancos de dados em um volume montado banco de dados em um remoto dispositivo baseado em Windows Embedded CE.

Syntax

HANDLE CeFindFirstDatabaseEx(
  PCEGUID pceguid, 
  DWORD dwDbaseType 
);

Parameters

  • pceguid
    [no] Ponteiro para o CEGUID que contém a identificador exclusivo (GUID) de um volume montado banco de dados. Se pceguid é NULL ou definido para um inválido GUID, todos os volumes montados banco de dados são pesquisadas.
  • dwDbaseType
    [no] Especifica o identificador tipo dos bancos de dados para enumerar. Se este parâmetro for zero, todos os bancos de dados são enumerados no volume. Para Windows Embedded CE com dispositivos, um volume é armazenar o objeto ou um volume montado banco de dados.

Valores Return

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

Para localizar todos os bancos de dados o tipo desejado, especificar o identificador contexto enumeração em múltiplo chamadas para o CeFindNextDatabaseEx função.

Remarks

Esta função só retorna o identificador para um contexto enumeração. Para começar a enumeração bancos de dados, um aplicativo deve chamar o CeFindNextDatabaseExfunção. Quando um aplicativo é feito com o identificador para o contexto enumeração, um aplicativo usa CeCloseHandle a versão de recursos associado com o contexto enumeração.

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
CeFindNextDatabaseEx (RAPI)
CeGetLastError (RAPI)