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 möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errBackupAbortByServer	Der Vorgang ist fehlgeschlagen, da die aktuelle externe Sicherung durch einen Aufruf von JetStopBackup abgebrochen 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 dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurde.
JET_errInstanceUnavailable	Der Vorgang kann nicht abgeschlossen werden, da bei der instance, 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	Fehler beim Sicherungsvorgang, weil er außerhalb der Sequenz aufgerufen wurde. JetTruncateLog gibt diesen Fehler zurück, wenn ausstehende Dateihandles vorhanden sind, die mit JetOpenFile für die instance erstellt wurden.
JET_errInvalidParameter	Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameter ergab ein unerwartetes Ergebnis. Dies kann für JetTruncateLog auftreten, wenn das angegebene instance Handle ungültig ist. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errNoBackup	Der Vorgang ist fehlgeschlagen, da keine externe Sicherung ausgeführt wird.
JET_errNotInitialized	Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.
JET_errRestoreInProgress	Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die instance 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, in dem nur eine instance unterstützt wird, wenn tatsächlich bereits mehrere Instanzen vorhanden sind.
JET_errTermInProgress	Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, heruntergefahren wird.

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

Wenn diese Funktion fehlschlägt, kann der Sicherungsstatuscomputer so erweitert werden, dass die Sicherung von Datenbankdateien nicht mehr zulässig ist. Eine bestimmte Anzahl von Transaktionsprotokolldateien kann gelöscht werden, die kleiner als die gewünschte Anzahl ist, aber sie werden immer von der ältesten zu den jüngsten gelöscht.

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.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

Erweiterbare Speichermoduldateien
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService