JetOSSnapshotEnd-Funktion

Gilt für: Windows | Windows Server

JetOSSnapshotEnd-Funktion

Die JetOSSnapshotEnd-Funktion benachrichtigt die Engine, dass die Momentaufnahme Sitzung abgeschlossen wurde.

Windows Vista:JetOSSnapshotEnd wird in Windows Vista eingeführt:

    JET_ERR JET_API JetOSSnapshotEnd(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Parameter

snapId

Der Bezeichner der Momentaufnahme Sitzung.

grbit

Die Optionen für diesen Aufruf. Dieser Parameter kann eine Kombination der folgenden Werte haben.

Wert	Bedeutung
0	Das erfolgreiche Ende der Momentaufnahme-Sitzung.
JET_bitAbortSnapshot	Die Momentaufnahme Sitzung wurde abgebrochen.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errInvalidGrbit	Eine der angeforderten Optionen ist ungültig, falsch verwendet oder nicht implementiert.
JET_errOSSnapshotInvalidSequence	Eine Momentaufnahme Sitzung wird bereits ausgeführt. Dies ist nicht zulässig.
JET_errOSSnapshotInvalidSnapId	Der Bezeichner für die Momentaufnahme Sitzung ist ungültig.
JET_errOSSnapshotTimeOut	Die Momentaufnahme Sitzung hatte vor diesem Aufruf ein internes Timeout. Daher wurden die E/A-Vorgänge vor diesem Aufruf wieder normalisiert.

Wenn diese Funktion erfolgreich ist, wird eine Momentaufnahme Sitzung abgeschlossen, und das normale Engine-Verhalten wird fortgesetzt. Eine neue Momentaufnahme-Sitzung kann später gestartet werden.

Wenn diese Funktion fehlschlägt, wird der JET_errOSSnapshotTimeOut Rückgabecode zurückgegeben, und die aktuelle Momentaufnahme Sitzung wird beendet, aber das Einfrieren von IOs während des Momentaufnahme Zeitraums wurde intern nicht berücksichtigt. Bei allen anderen Fehlern wird der Momentaufnahme Sitzungszustand nicht geändert.

Bemerkungen

Diese Funktion wird nur aufgerufen, wenn JetOSSnapshotThaw mit JET_bitContinueAfterThaw aufgerufen wurde.

Die Momentaufnahme Sitzung muss abgeschlossen werden, damit die Momentaufnahme Überprüfung und Protokollkürzung erfolgt. Ereignisprotokolleinträge werden für die verschiedenen Schritte der Momentaufnahme generiert.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista.
Server	Erfordert Windows Server 2008.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

Fehlerbehandlungsparameter
Fehler der erweiterbaren Speicher-Engine
JET_ERR
JetOSSnapshotThaw