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)