CeCreateSession (EDB)

9/8/2008

Essa função cria uma sessão para começar, confirmação, ou rolo voltar transações.

Essa função não trabalho com bancos de dados CEDB. Para obter mais informações sobre CEDB, consulte CEDB Reference.

Syntax

HANDLE CeCreateSession(
  CEGUID* pGuid
);

Parameters

• pGuid
  [no] CEGUID do volume montado para o qual criar a sessão. Monte um volume usando a função CeMountDBVolEx (EDB).

Return Value

INVALID_HANDLE_VALUE indica falha. Para informações de erro estendidas get, chamar GetLastError. A seguinte tabela lista os valores possíveis.

Return valor	Descrição
ERROR_INVALID_PARAMETER	O pGuid parâmetro for definido como NULL.
ERROR_NOT_FOUND	O volume não está montado, ou pGuid não é um válido GUID.

Remarks

Transações GRUPO um conjunto de transformar em uma operação única confirmação atômicas assim que ambos todas as alterações ocorrer, ou nenhum. Transações proteção contra parcialmente modificados bancos de dados em um sistema falhar ou falha de energia.

Se você transmitir NULL de identificador de sessão ao abrir um banco de dados, edb internamente cria uma nova sessão para que banco de dados aberto, e cada operação executada no banco de dados é atômica. Obter o identificador sessão para um banco de dados abertos, chamado de função CeGetDatabaseSession (EDB).

Mesmo se você transmitir um identificador sessão quando você aberto um banco de dados, você não tiver começado uma transação. Você deve primeiro chamar a função CeBeginTransaction (EDB) para uma sessão. Em seguida, todas as alterações feitas a todos os bancos de dados aberto com que sessão são registrados até você chamar a função CeEndTransaction (EDB). CeEndTransaction Permite que você qualquer confirmação ou reverter voltar todas as alterações feitas na sessão desde o compatível CeBeginTransaction chamar foi feita.

Depois que você tenha aberto um banco de dados, não é possível alteração sua sessão.

Uma única transação não pode abranger múltiplo volumes. No entanto, é possível executar uma transação que abranja múltiplo bancos de dados em um volume, passando o mesmo identificador sessão na chamar a função de CeOpenDatabaseInSession (EDB).

O identificador retornado desta função deve ser fechada por chamado a função CloseHandle. Se uma sessão é fechado e ele ainda está em uma transação, todas as alterações não confirmadas são roladas voltar.

Requirements

Header	windbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 5.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

EDB Functions
CeMountDBVolEx (EDB)
CeGetDatabaseSession (EDB)
CeBeginTransaction (EDB)
CeEndTransaction (EDB)
CeOpenDatabaseInSession (EDB)
CloseHandle