JetOSSnapshotPrepare-Funktion

Gilt für: Windows | Windows Server

JetOSSnapshotPrepare-Funktion

Die JetOSSnapshotPrepare-Funktion beginnt mit den Vorbereitungen für eine Momentaufnahmesitzung. Eine Momentaufnahmesitzung ist ein kurzes Zeitintervall, in dem das Modul keine Schreib-E/As auf den Datenträger ausgibt, sodass das Modul an einer Volumemomentaufnahmesitzung teilnehmen kann (wenn es von einem Momentaufnahme-Writer gesteuert wird).

Windows XP:JetOSSnapshotPrepare wird in Windows XP eingeführt.

    JET_ERR JET_API JetOSSnapshotPrepare(
      __out         JET_OSSNAPID* psnapId,
      __in          const JET_GRBIT grbit
    );

Parameter

psnapId

Der Bezeichner der zu startenden Momentaufnahmesitzung.

grbit

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

Wert	Bedeutung
0	Normale Momentaufnahme.
JET_bitIncrementalSnapshot	Es werden nur Protokolldateien übernommen.
JET_bitCopySnapshot	Eine Momentaufnahme einer Kopie (normal oder inkrementell) ohne Protokollabkürzung.
JET_bitContinueAfterThaw	Die Momentaufnahmesitzung tritt nach JetOSSnapshotThaw auf und erfordert den Aufruf der JetOSSnapshotEnd--Funktion.
JET_bitExplicitPrepare	Standardmäßig werden keine Instanzen vorbereitet. Windows 7: JET_bitExplicitPrepare wird in Windows 7 eingeführt.

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 Fehler beim Extensible Storage Engine und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich beendet.
JET_errInvalidParameter	Der Snapshot-ID-Zeiger ist NULL, oder der Grbit-Parameter ist ungültig.
JET_errOSSnapshotInvalidSequence	Es wird bereits eine Momentaufnahmesitzung ausgeführt, und der Vorgang darf zu einem bestimmten Zeitpunkt nicht mehr als eine Momentaufnahmesitzung haben.

Wenn diese Funktion erfolgreich ist, kann eine Momentaufnahmesitzung jederzeit mit der E/A-Fixierungsphase beginnen. Der Bezeichner für die Sitzung wird zurückgegeben und muss in den nachfolgenden Aufrufen für die Momentaufnahmesitzung verwendet werden.

Die ausgeführten Instanzen des Moduls werden nun als Teil der Momentaufnahmesitzung betrachtet.

Windows Vista: Um eine andere Teilmenge von Instanzen anzugeben, kann jetOSSnapshotPrepareInstance aufgerufen werden.

Der normale API-Sequenzaufruf lautet: JetOSSnapshotPrepare, optional gefolgt von einem oder mehreren Aufrufen von JetOSSnapshotPrepareInstance , gefolgt von JetOSSnapshotFreeze. Nachdem die Fixierung gestartet wurde, kann sie mit JetOSSnapshotThaw beendet werden. Nach der Vorbereitung kann die Momentaufnahmesitzung jederzeit mit JetOSSnapshotAbort abrupt beendet werden.

Wenn „JET_bitContinueAfterThaw“ nach JetOSSnapshotThaw angegeben wird, bleibt die Momentaufnahmesitzung erhalten (obwohl die E/A fortgesetzt wird). Dadurch wird eine Überprüfung der Momentaufnahme und bei Bedarf die Protokollabkürzung mithilfe von JetOSSnapshotTruncateLog aktiviert. Ein Aufruf von JetOSSnapshotEnd wird benötigt.

Wenn diese Funktion fehlschlägt, ändert sich der Modulzustand nicht.

Hinweise

Ereignisprotokolleinträge werden für die verschiedenen Schritte der Momentaufnahme generiert.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Übergeordnet	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog