JetOSSnapshotTruncateLog-Funktion

Artikel
06/12/2023

Gilt für: Windows | Windows Server

JetOSSnapshotTruncateLog-Funktion

Die JetOSSnapshotTruncateLog-Funktion ermöglicht die Protokollabkürzung für alle Instanzen, die Teil der Momentaufnahme-Sitzung sind.

Windows Vista:JetOSSnapshotTruncateLog wird in Windows Vista eingeführt.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __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 aufweisen.

Wert	Bedeutung
JET_bitAllDatabasesSnapshot	Alle Datenbanken sind angefügt, damit die Speicher-Engine berechnen und die Protokollabkürzung durchführen kann.
0 (Null)	Es wird keine Abschneidung durchgeführt.

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp 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	Der grbit-Parameter ist ungültig.
JET_errOSSnapshotInvalidSequence	Die Momentaufnahme Sitzung befindet sich nicht in dem Zustand, in dem eine Abschneidung auftreten kann. Mögliche Ursachen sind: der Aufruf erfolgt nach dem Timeout der Momentaufnahme Sitzung Die Sitzung wurde als Kopier-Momentaufnahme angegeben.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errInvalidGrbit

Der grbit-Parameter ist ungültig.

JET_errOSSnapshotInvalidSequence

Die Momentaufnahme Sitzung befindet sich nicht in dem Zustand, in dem eine Abschneidung auftreten kann. Mögliche Ursachen sind:

der Aufruf erfolgt nach dem Timeout der Momentaufnahme Sitzung
Die Sitzung wurde als Kopier-Momentaufnahme angegeben.

Bei Erfolg werden die Protokolldateien für eine oder alle Instanzen, die teil der Momentaufnahme Sitzung sind, nach Möglichkeit abgeschnitten.

Bemerkungen

Diese Funktion sollte nur aufgerufen werden, wenn die Momentaufnahme mit der Option JET_bitContinueAfterThaw erstellt wurde. Andernfalls wäre die Momentaufnahme Sitzung nach dem JetOSSnapshotThaw-Anruf beendet worden.

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
Erweiterbare Speicher-Engine-Fehler
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

Share via

JetOSSnapshotTruncateLog-Funktion