Função JetCommitTransaction

Aplica-se a: Windows | Windows Server

Função JetCommitTransaction

A função JetCommitTransaction confirma as alterações feitas no estado do banco de dados durante o ponto de salvamento atual e as migra para o ponto de salvamento anterior. Se o ponto de salvamento mais externo for confirmado, as alterações feitas durante esse ponto de salvamento serão confirmadas no estado do banco de dados e a sessão sairá da transação.

    JET_ERR JET_API JetCommitTransaction(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parâmetros

sesid

A sessão a ser usada para essa chamada.

grbit

Um grupo de bits que especifica zero ou mais das opções a seguir.

Valor	Significado
JET_bitCommitLazyFlush	A transação é confirmada normalmente, mas essa API não aguarda que a transação seja liberada para o arquivo de log de transações antes de retornar ao chamador. Isso reduz drasticamente a duração de uma operação de confirmação ao custo da durabilidade. Qualquer transação que não seja liberada para o log antes de uma falha será anulada automaticamente durante a recuperação de falha durante a próxima chamada para JetInit. Se JET_bitWaitLastLevel0Commit ou JET_bitWaitAllLevel0Commit forem especificados, essa opção será ignorada. Se essa chamada para JetCommitTransaction não corresponder à primeira chamada para JetBeginTransaction para esta sessão, essa opção será ignorada. Isso ocorre porque a ação final que ocorre no ponto de salvamento mais externo é o fator determinante para determinar se a transação inteira está realmente confirmada no disco.
JET_bitWaitAllLevel0Commit	Todas as transações confirmadas anteriormente por qualquer sessão que ainda não foram liberadas para o arquivo de log de transações serão liberadas imediatamente. Essa API aguardará até que as transações tenham sido liberadas antes de retornar ao chamador. Essa opção pode ser usada mesmo que a sessão não esteja atualmente em uma transação. Essa opção não pode ser usada em combinação com nenhuma outra opção. Essa opção só está disponível a partir do Windows Server 2003.
JET_bitWaitLastLevel0Commit	Se a sessão tiver confirmado anteriormente todas as transações e elas ainda não tiverem sido liberadas para o arquivo de log de transações, elas deverão ser liberadas imediatamente. Essa API aguardará até que as transações tenham sido liberadas antes de retornar ao chamador. Isso será útil se o aplicativo tiver confirmado várias transações anteriormente usando JET_bitCommitLazyFlush e agora quiser liberar todas elas para o disco. Essa opção pode ser usada mesmo que a sessão não esteja atualmente em uma transação. Essa opção não pode ser usada em combinação com nenhuma outra opção.

Valor Retornado

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros de ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.
JET_errClientRequestToStopJetService	Não é possível concluir a operação porque todas as atividades na instância associada à sessão cessaram como resultado de uma chamada para JetStopService.
JET_errInstanceUnavailable	Não é possível concluir a operação porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Esse erro só será retornado pelo Windows XP e versões posteriores.
JET_errInvalidgrbit	Uma das opções solicitadas era inválida ou não implementada. Esse erro será retornado por JetCommitTransaction quando: Um grbit inválido é especificado. JET_bitWaitLastLevel0Commit foi especificado em combinação com outro grbit. JET_bitWaitAllLevel0Commit foi especificado em combinação com outro grbit.
JET_errNotInitialized	Não é possível concluir a operação porque a instância associada à sessão ainda não foi inicializada.
JET_errNotInTransaction	A operação falhou porque a sessão fornecida não está em uma transação.
JET_errRestoreInProgress	Não é possível concluir a operação porque uma operação de restauração está em andamento na instância associada à sessão.
JET_errSessionSharingViolation	A mesma sessão não pode ser usada para mais de um thread ao mesmo tempo. Esse erro só será retornado pelo Windows XP e versões posteriores.
JET_errTermInProgress	Não é possível concluir a operação porque a instância associada à sessão está sendo desligada.

Em caso de êxito, todas as alterações feitas no banco de dados durante o ponto de salvamento atual para a sessão determinada serão confirmadas e esse ponto de salvamento será encerrado. Se o último ponto de salvamento da sessão tiver sido encerrado, a transação será opcionalmente liberada para o arquivo de log de transações e a sessão sairá da transação.

Em caso de falha, o estado transacional da sessão permanecerá inalterado. Nenhuma alteração no estado do banco de dados ocorrerá. O aplicativo deve chamar JetRollback para anular a transação.

Comentários

Deve haver uma chamada para JetCommitTransaction ou JetRollback para corresponder a cada chamada para JetBeginTransaction para uma determinada sessão.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.

Consulte Também

JET_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction
JetCommitTransaction
JetRollback
JetStopService