CeOpenDatabaseEx (CEDB)

9/8/2008

Essa função abrirá uma banco de dados existente em quaisquer volumes montados banco de dados. Essa função é obsoleto. Chame o funcition CeOpenDatabaseEx2 (CEDB) em vez disso.

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

Syntax

HANDLE CeOpenDatabaseEx( 
  PCEGUID pceguid, 
  PCEOID poid,
  LPWSTR lpszName, 
  CEPROPID propid, 
  DWORD dwFlags,
  CENOTIFYREQUEST* pReq
);

Parameters

• pceguid
  [no] Ponteiro para o CEGUID que contém o globalmente exclusivo identifierof um volume montado banco de dados ou de armazenar o objeto. Use a macro CREATE_SYSTEMGUID para obter a GUID de armazenar o objeto. Se este parâmetro aponta para um CEGUID Criado com a macro CREATE_INVALIDGUID, a poid parâmetro será ignorado e armazenar o objeto e todos os volumes montados banco de dados são pesquisados de um banco de dados cujo nome corresponde lpszName. A pesquisa é concluída quando a primeira correspondência está localizada.

• 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 apontado por esse parâmetro para zero, definido lpszName Para o nome do banco de dados e conjunto pceguid Para o volume banco de dados.

• lpszName
  [no] Ponteiro longo para o seqüência de caracteres NULL-Terminated que contém o nome do banco de dados para ser aberto. Isso é usado junto com pceguid Para especificar o banco de dados se o valor apontado pelo poid é zero. Se o valor apontado pelo poid é diferente de zero, este parâmetro é ignorado.

• Propid
  [no] Propriedade identificador do chave de classificação para o banco de dados. 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	Incrementa a atual posição buscar com cada chamar a função de CeReadRecordPropsEx (CEDB).
  Zero	Impede que a atual posição buscar do que está sendo incrementada com cada chamar para CeReadRecordPropsEx. A posição de busca é alterada somente por chamadas para a função CeSeekDatabaseEx (CEDB).

• pReq
  [no] Ponteiro para uma estrutura CENOTIFYREQUEST (CEDB) que solicita notificações ser enviadas para uma janela identificada. Este parâmetro pode ser definido como NULL se um aplicativo não precisar receber notificações.

Return Value

Um 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. Esta código de erro se aplica somente 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 não houve suficiente disponível memória para alocar o identificador banco de dados.

Remarks

Um aplicativo deve usar a função CloseHandle para fechar o identificador retornado por essa função.

As alterações em bancos de dados Windows Embedded CE sejam confirmadas após cada individual chamar, não quando abrindo e fechando um banco de dados.

Requirements

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

See Also

Reference

CEDB Functions
CeCreateDatabaseEx (CEDB)
CeReadRecordPropsEx (CEDB)
CeSeekDatabase (CEDB)
CloseHandle
CREATE_INVALIDGUID
CENOTIFICATION (CEDB)
CeOpenDatabaseEx2 (CEDB)