JetOSSnapshotTruncateLogInstance-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetOSSnapshotTruncateLogInstance-Funktion

Die JetOSSnapshotTruncateLogInstance-Funktion schneidet das Protokoll für eine angegebene instance während einer Momentaufnahme-Sitzung ab.

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

    JET_ERR JET_API JetOSSnapshotTruncateLogInstance(
      __in          const JET_OSSNAPID snapId,
      __in          JET_INSTANCE instance,
      __in          const JET_GRBIT grbit
    );

Parameter

snapId

Der Bezeichner der Momentaufnahme Sitzung.

instance

Die instance, die für diesen Aufruf verwendet wird.

grbit

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

grbit kann einer der folgenden Werte sein:

Wert

Bedeutung

JET_bitAllDatabasesSnapshot

Alle Datenbanken sind angefügt, damit die Speicher-Engine berechnen und die Protokollkürzung durchführen kann.

0 (Null)

Es wird keine Abschneidung durchgefü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 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 ein Abschneiden auftreten kann. Mögliche Ursachen sind:

  • Der Aufruf wird nach einem Timeout der Momentaufnahme Sitzung abgeschlossen.

  • Die Sitzung wurde als Kopie Momentaufnahme angegeben.

Wenn diese Funktion erfolgreich ist, 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 endet die Momentaufnahme-Sitzung nach dem Aufruf von JetOSSnapshotThaw.

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