JetOSSnapshotEnd-Funktion

  • Artikel

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