JetOSSnapshotEnd-Funktion

Gilt für: Windows | Windows Server

JetOSSnapshotEnd-Funktion

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

**Windows Vista:**JetOSSnapshotEnd wurde 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 Momentaufnahmesitzung.

grbit

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

Wert

Bedeutung

0

Das erfolgreiche Ende der Momentaufnahmesitzung.

JET_bitAbortSnapshot

Die Momentaufnahmesitzung wurde abgebrochen.

Rückgabewert

Diese Funktion gibt den JET_ERR Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errInvalidGrbit

Eine der angeforderten Optionen ist ungültig, wird falsch verwendet oder nicht implementiert.

JET_errOSSnapshotInvalidSequence

Eine Momentaufnahmesitzung wird bereits ausgeführt. Dies ist nicht zulässig.

JET_errOSSnapshotInvalidSnapId

Der Bezeichner für die Momentaufnahmesitzung ist ungültig.

JET_errOSSnapshotTimeOut

Die Momentaufnahmesitzung hatte vor diesem Aufruf ein internes Timeout. Daher wurden die E/A-Vorgänge wieder normalisiert, bevor dieser Aufruf durchgeführt wurde.

Wenn diese Funktion erfolgreich ausgeführt wird, wird eine Momentaufnahmesitzung abgeschlossen, und das normale Engine-Verhalten wird fortgesetzt. Eine neue Momentaufnahmesitzung kann später gestartet werden.

Wenn diese Funktion fehlschlägt, gibt der JET_errOSSnapshotTimeOut Rückgabecode zurück, und die aktuelle Momentaufnahmesitzung wird beendet, aber das Einfrieren von IOs während des Momentaufnahmezeitraums wurde intern nicht berücksichtigt. Bei allen anderen Fehlern wird der Zustand der Momentaufnahmesitzung nicht geändert.

Bemerkungen

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

Die Momentaufnahmesitzung muss abgeschlossen sein, damit die Momentaufnahmeüberprüfung und Protokollkürzung durchgeführt werden kann. Ereignisprotokolleinträge werden für die verschiedenen Schritte der Momentaufnahme generiert.

Requirements (Anforderungen)

Anforderung Wert

Client

Erfordert Windows Vista.

Server

Erfordert Windows Server 2008.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

Fehlerbehandlungsparameter
Erweiterbare Storage-Engine-Fehler
JET_ERR
JetOSSnapshotThaw