CeOpenDatabase (RAPI)

9/8/2008

Essa função abre um banco de dados existente em armazenar o objeto em um remoto dispositivo baseado em Windows Embedded CE.

Observação

Esse método foi substituído.Uso CeOpenDatabaseEx Em vez disso.

Syntax

HANDLE CeOpenDatabase (
  PCEOID poid, 
  LPWSTR lpszName, 
  CEPROPID propid, 
  DWORD dwFlags, 
  HWND hwndNotify 
);

Parameters

• poid
  [in, Out] Ponteiro ao identificador de objeto do banco de dados para ser aberto. Para aberto um banco de dados pelo nome, defina o valor apontado pelo poid Para zero para receber identificador de objeto do banco de dados recém-abertos quando um nome do banco de dados for especificado para lpszName.

• lpszName
  [no] Ponteiro para o seqüência de caracteres NULL-Terminated que contém o nome do banco de dados para ser aberto. Este parâmetro é ignorado se o valor apontado pelo poid é diferente de zero.

• Propid
  [no] Propriedade identificador do chave primária para a ordem classificar na qual o banco de dados é ser atravessados. Todas as chamadas subseqüentes para CeSeekDatabase Suponha que esta ordem classificar. Este parâmetro pode ser zero se a ordem classificar não é importante.

• dwFlags
  [no] Especifica um máscara de bits de ação sinalizadores. Ele é um do seguinte valores.

  Valor	Descrição
  CEDB_AUTOINCREMENT	Posição buscar atual é automaticamente incrementadas com cada chamar para o CeReadRecordProps função.
  0 (Zero)	Posição buscar atual não é incrementada com cada chamar para CeReadRecordProps.

• hwndNotify
  [no] Não com suporte; Definir como NULL.

Return Value

O identificador para o aberto banco de dados indica sucesso. INVALID_HANDLE_VALUE Indica falha. Para informações de erro estendidas get, chamar CeGetLastError e CeRapiGetError. Valores possíveis para CeGetLastError Incluir o seguinte:

• ERROR_INVALID_PARAMETER
  Foi um parâmetro inválido.

• ERROR_FILE_NOT_FOUND
  Nenhuma banco de dados existe com o nome especificado. Esta código de erro se aplica somente se o valor apontado pelo poid foi definido para NULL, quando a função foi chamado.

• ERROR_NOT_ENOUGH_MEMORY
  Nenhuma memória estava disponível para alocar um identificador banco de dados.

Remarks

Use o CeCloseHandle função para fechar o identificador retornado pela CeOpenDatabase função.

Abrindo e fechando um banco de dados Windows Embedded CE não causar qualquer transações para ser confirmada. Em outras palavras, transações banco de dados não são confirmadas quando o banco de dados é fechado, eles são confirmados após cada individual chamar.

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
CeCreateDatabase (RAPI)
CeSeekDatabase (RAPI)