CeOpenDatabase (CEDB)

9/8/2008

Essa função abrirá um banco de dados existente. Essa função é obsoleto. Chame a função CeOpenDatabaseEx2 (CEDB) em vez disso.

Uma versão RAPI dessa função existe chamado CeOpenDatabaseEx (RAPI).

Syntax

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

Parameters

• poid
  [no] Ponteiro ao identificador de objeto do banco de dados para ser aberto. Para aberto um banco de dados pelo nome, defina o valor apontada por esse parâmetro para zero para receber o identificador 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 é definido como diferente de zero.

• Propid
  [no] Propriedade identificador da chave para a ordem classificar na qual o banco de dados é ser atravessados. Todas as chamadas subseqüentes para a função CeSeekDatabase (CEDB) assumem essa ordem classificar. Este parâmetro pode ser definido para zero se a ordem classificar não é importante. Em que maiúsculas e minúsculas, uma ordem classificar é escolhido para você.

• dwFlags
  [no] Máscara de bits de ação sinalizadores. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  CEDB_AUTOINCREMENT	Faz com que a atual posição buscar seja automaticamente incrementadas com cada chamar a função de CeReadRecordProps (CEDB).
  Zero	Impede que a atual posição buscar do que está sendo incrementada com cada chamar para CeReadRecordProps. A posição de busca é alterada somente por chamadas para a função CeSeekDatabaseEx (CEDB).

• hwndNotify
  [no] Identificador para a janela para que notificação mensagens (DB_CEOID_*) serão postadas se outro segmento modifica o banco de dados especificado enquanto ele estiver aberto. Este parâmetro pode ser definido como NULL se você não precisar receber notificações.

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 GetLastError. A seguinte tabela mostra os valores possíveis.

Valor	Descrição
ERROR_FILE_NOT_FOUND	Indica que não banco de dados existe com o nome especificado. Este valor aplica-se apenas se o valor apontado pelo poid parâmetro foi definido para NULL quando a função foi chamado.
ERROR_INVALID_PARAMETER	Indica que um parâmetro estava inválido.
ERROR_NOT_ENOUGH_MEMORY	Indica que nenhuma memória estava disponível para alocar um identificador banco de dados.

Remarks

Use a função CloseHandle para fechar o identificador retornado por essa função.

Ao contrário dos vários outros bancos de dados, tradicionais abrindo e fechando um banco de dados não implicam que as transações ocorrer. Em outras palavras, o banco de dados não é confirmado no fechamento. É confirmada após cada individual chamar.

Um aplicativo que abre o mesmo banco de dados more than uma vez e solicitações para ser notificado sobre alterações de banco de dados recebe notificação de alteração para alterações que o processo fez sobre o banco de dados. O processo notificação de alteração não é feito em um processo nível, mas em uma por banco de dados - aberto - nível.

Requirements

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

See Also

Reference

CEDB Functions
CeCreateDatabase (CEDB)
CeOpenDatabaseEx (CEDB)
CeSeekDatabase (CEDB)
CeOpenDatabaseEx2 (CEDB)
CloseHandle