CeOpenDatabaseEx (RAPI)

9/8/2008

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

Syntax

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

Parameters

• pceguid
  [no] Ponteiro para o CEGUID que contém a identificador exclusivo (GUID) de um banco de dados montado. Se pceguid é igual a CREATE_INVALIDGUID, em seguida, poid é ignorado, e os bancos de dados todos montados e armazenar objeto são pesquisados em busca de um banco de dados cujo nome corresponde lpszName. 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 pelo poid para zero, defina 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, lpszName é ignorado.

• Propid
  [no] Propriedade identificador do primário para o banco de dados chave de classificação. 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. Em que maiúsculas e minúsculas, uma ordem classificar será escolhido para você.

• dwFlags
  [no] Especifica um sinalizador ação. Ele é um do seguinte sinalizadores.

  Valor	Descrição
  CEDB_AUTOINCREMENT	Posição buscar atual é automaticamente incrementadas com cada chamar para CeReadRecordPropsEx.
  0	Posição buscar atual não é incrementada com cada chamar para CeReadRecordPropsEx.

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

Valores Return

Um 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 o identificador banco de dados.

Remarks

Um aplicativo deve usar o CeCloseHandle função para fechar o identificador retornado pela CeOpenDatabaseEx 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
CeCreateDatabaseEx (RAPI)
CeReadRecordPropsEx (RAPI)
CeSeekDatabase (RAPI)