CeOpenDatabaseEx2 (CEDB)

9/8/2008

Essa função abrirá uma banco de dados existente em qualquer volume banco de dados, incluindo volumes montados banco de dados.

Essa função não trabalho com bancos de dados Edb. Para obter mais informações, consulte EDB Functions.

Syntax

HANDLE CeOpenDatabaseEx2( 
  PCEGUID pguid, 
  PCEOID poid,
  LPWSTR lpszName, 
  SORTORDERSPECEX* psort, 
  DWORD dwFlags,
  CENOTIFYREQUEST* pRequest
);

Parameters

• pguid
  [no] Ponteiro para o CEGUID que contém a identificador exclusivo de 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, este parâmetro é ignorado, e armazena a objeto e todos os volumes montados banco de dados são pesquisados de um banco de dados cujo nome corresponde a lpszName parâmetro. A pesquisa é concluída quando a primeira correspondência está localizada.

• 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 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 é definido como zero. Se o valor apontado pelo poid está definido para diferente de zero, este parâmetro é ignorado.

• psort
  [no] Ordem classificar ativo para o banco de dados. Todas as chamadas subseqüentes para a função CeSeekDatabaseEx (CEDB) assumem essa ordem classificar. Este parâmetro pode ser definido como NULL se a ordem classificar não for 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).

• pRequest
  [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.

  O ponteiro classificar não é necessário apontar para uma das estruturas de classificar usadas em chamar a criação, mas o propids Ter para coincidir com uma das classificações de banco de dados.

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 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 .NET 4.0 and later

See Also

Reference

CEDB Functions
CeCreateDatabaseEx2 (CEDB)
CeReadRecordPropsEx (CEDB)
CeSeekDatabaseEx (CEDB)
CloseHandle
CREATE_INVALIDGUID
CENOTIFICATION (CEDB)