Freigeben über


JetBeginTransaction2-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetBeginTransaction2-Funktion

Die Funktion JetBeginTransaction2 wird eine Sitzung eine Buchung eingeben, und erstellen Sie einen neuen Sicherungspunkt. Diese Funktion kann mehr als einmal in einer einzigen Sitzung erstellt zusätzliche Punkte speichern aufgerufen werden. Diese speichern Punkte können zu selektiv zu beibehalten oder verwerfen von Änderungen an der Datenbank verwendet werden.

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

Parameter

sesid

Die Sitzung für diesen Aufruf verwenden.

JET_errInvalidGrbit

Eine Gruppe von Bits, die Optionen für diesen Aufruf enthalten die 0 (null) oder mehr der folgenden enthalten.

Wert

Bedeutung

JET_bitTransactionReadOnly

Die Transaktion kann die Datenbank nicht ändern. Wenn eine Aktualisierung versucht wird, wird dieser Vorgang mit JET_errTransReadOnly fehl. Diese Option wird ignoriert, wenn sie dazu aufgefordert werden, wenn die Sitzung nicht bereits in einer Transaktion befindet. Diese Option ist nur ab Windows XP verfügbar.

Return Value

Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Es ist nicht möglich, um den Vorgang abzuschließen, da alle Aktivitäten in der Instanz dieser Sitzung aufgrund eines Aufrufs von JetStopServiceeingestellt hat.

JET_errInstanceUnavailable

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz ein schwerwiegender Fehler, der erfordert aufgetreten ist, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen.

Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errNotInitialized

Es ist nicht möglich, um den Vorgang abzuschließen, da die Instanz dieser Sitzung noch nicht initialisiert wurde.

JET_errRestoreInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da ein Wiederherstellungsvorgang ausgeführt auf die Instanz der Sitzung zugeordnet wird.

JET_errSessionSharingViolation

Die gleiche Sitzung kann für mehrere Threads gleichzeitig verwendet werden. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errTermInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz heruntergefahren wird.

JET_errTransTooDeep

Eine neue Transaktion kann nicht gestartet werden, da die Sitzung bereits den Maximalwert speichern Punkttiefe zulässige wird durch die Datenbank-Engine.

Bei Erfolg wird die bereitgestellte Sitzung innerhalb einer Transaktion sein. Wenn die Sitzung wurde wird zuvor innerhalb einer Transaktion dann eine neu speichern Punkt erstellt.

Bei einem Fehler bleiben den Transaktionsstatus der Sitzung unverändert. Keine Änderung an den Zustand der Datenbank erfolgt.

Anmerkungen

Weitere Informationen über die Funktionsweise von Transaktionen finden Sie unter JetBeginTransaction.

Voraussetzungen

-Client,

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server.

Kopfzeile

In Esent.h deklariert.

Library

Verwenden Sie ESENT.lib.

DLL

"ESENT.dll" erfordert.

Siehe auch

JET_ERR
JET_GRBIT
JET_SESID
JetBeginTransaction
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
Systemparameter