JetOSSnapshotTruncateLog-Funktion

Gilt für: Windows | Windows Server

JetOSSnapshotTruncateLog-Funktion

Die JetOSSnapshotTruncateLog-Funktion ermöglicht die Protokollkürzung für alle Instanzen, die Teil der Momentaufnahmesitzung 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 Momentaufnahmesitzung.

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 die Protokollkürzung berechnen und durchführen kann.

0 (Null)

Es erfolgt keine Kürzung.

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

Der grbit-Parameter ist ungültig.

JET_errOSSnapshotInvalidSequence

Die Momentaufnahmesitzung befindet sich nicht in dem Zustand, in dem eine Kürzung erfolgen kann. Mögliche Ursachen sind:

  • Der Aufruf erfolgt nach dem Time out der Momentaufnahmesitzung.

  • Die Sitzung wurde als Kopiermomentaufnahme angegeben.

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

Hinweise

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

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
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw