JetTruncateLog-Funktion

Gilt für: Windows | Windows Server

JetTruncateLog-Funktion

Die JetTruncateLog-Funktion wird während einer Sicherung verwendet, die von JetBeginExternalBackup initiiert wird, um alle Transaktionsprotokolldateien zu löschen, die nach erfolgreichem Abschluss der aktuellen Sicherung nicht mehr benötigt werden.

    JET_ERR JET_API JetTruncateLog(void);

Parameter

Diese Funktion besitzt keine Parameter.

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_errBackupAbortByServer

Fehler beim Vorgang, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen wurde.

Windows Server 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt.

JET_errClientRequestToStopJetService

Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopServicebeendet wurden.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, da für die Instanz, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errInvalidBackupSequence

Der Sicherungsvorgang ist fehlgeschlagen, da er außerhalb der Sequenz aufgerufen wurde. JetTruncateLog gibt diesen Fehler zurück, wenn ausstehende Dateihandles vorhanden sind, die mit JetOpenFile für die Instanz erstellt wurden.

JET_errInvalidParameter

Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameter führte zu einem unerwarteten Ergebnis. Dies kann für JetTruncateLog auftreten, wenn das angegebene Instanzhandle ungültig ist.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errNoBackup

Fehler beim Vorgang, weil keine externe Sicherung ausgeführt wird.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist.

JET_errRunningInMultiInstanceMode

Der Vorgang ist fehlgeschlagen, weil versucht wurde, die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) zu verwenden, wobei nur eine Instanz unterstützt wird, wenn tatsächlich bereits mehrere Instanzen vorhanden sind.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die instanz, die der Sitzung zugeordnet ist, heruntergefahren wird.

Wenn diese Funktion erfolgreich ausgeführt wird, werden die Transaktionsprotokolldateien gelöscht, die nach erfolgreichem Abschluss der aktuellen Sicherung nicht mehr benötigt werden. Der Sicherungsstatuscomputer wird erweitert, sodass die Sicherung von Datenbankdateien nicht mehr zulässig ist. Nur Datenbankpatchdateien und Transaktionsprotokolldateien dürfen für die Sicherung über diesen Punkt hinaus geöffnet werden.

Wenn diese Funktion fehlschlägt, kann der Sicherungsstatuscomputer erweitert werden, sodass die Sicherung von Datenbankdateien nicht mehr zulässig ist. Möglicherweise werden einige Transaktionsprotokolldateien gelöscht, die kleiner als die gewünschte Zahl sind, aber sie werden immer vom ältesten zum ersten Gelöschten gelöscht.

Requirements (Anforderungen)

Anforderung Wert

Client

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

Erweiterbare Storage-Engine-Dateien
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService