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