CeFindFirstDatabase (RAPI)

9/8/2008

Essa função abre um contexto enumeração para habilitar um aplicativo para enumerar todos os bancos de dados em armazenar o objeto em um remoto dispositivo baseado em Windows Embedded CE.

Observação

Esse método foi substituído.Use CeFindFirstDatabaseEx (RAPI).

Syntax

HANDLE CeFindFirstDatabase(
  DWORD dwDbaseType 
);

Parameters

• dwDbaseType
  [no] Identificador de tipo dos bancos de dados para enumerar. Se este parâmetro for zero, todos os bancos de dados são enumerados. Esse valor é definido pelo aplicativo e é definido quando o banco de dados é criado usando o CeCreateDatabase (RAPI) e CeCreateDatabaseEx (RAPI) métodos.

Return Value

Um identificador para um contexto enumeração indica sucesso. INVALID_HANDLE_VALUE indica falha.

Quando passada uma NULL valor na dwDbaseType parâmetro, CeFindFirstDatabase Retorna um identificador e define o último erro ERROR_INVALID_PARAMETER.

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.

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 a função CeFindNextDatabase (RAPI).

Use a função CeCloseHandle (RAPI) para fechar um identificador retornado pela CeFindFirstDatabase funçã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
CeFindFirstDatabase
CeFindNextDatabase (RAPI)
CeCloseHandle (RAPI)