JetTruncateLog-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetTruncateLog-Funktion
Die Funktion JetTruncateLog wird während einer Sicherung verwendet, die durch JetBeginExternalBackup , alle Transaktionsprotokolldateien löschen, die nicht mehr benötigt wird, nach dem erfolgreichen Abschluss die aktuelle Sicherung initiiert wird.
JET_ERR JET_API JetTruncateLog(void);
Parameter
Diese Funktion hat keine Parameter.
Return Value
Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errBackupAbortByServer |
Der Vorgang ist fehlgeschlagen, da ein Aufruf von JetStopBackupdie aktuelle externe Sicherung abgebrochen wurde. WindowsServer 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf die Instanz, die mit der Sitzung ist, aufgrund eines Aufrufs von JetStopServiceeingestellt hat. |
JET_errInstanceUnavailable |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die mit der Sitzung ist, ein schwerwiegender Fehler, der erfordert aufgetreten ist, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt. |
JET_errInvalidBackupSequence |
Der Sicherungsvorgang ist fehlgeschlagen, da sie außerhalb der Reihenfolge aufgerufen wurde. JetTruncateLog gibt diesen Fehler zurück, wenn gibt es ausstehenden Dateihandles, die Verwendung von JetOpenFile für die Instanz erstellt wurden. |
JET_errInvalidParameter |
Einer der Parameter, der bereitgestellt wurde einen unerwarteten Wert enthalten oder die Kombination verschiedener Parameter ein unerwartetes Ergebnis zurückgegeben. Dies kann für JetTruncateLog auftreten, wenn das Handle für die angegebene Instanz 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 Instanz, die mit der Sitzung ist, noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, dem die Sitzung zugeordnet ist. |
JET_errRunningInMultiInstanceMode |
Der Vorgang ist fehlgeschlagen, da versucht wurde, die Engine im legacy-Modus (Windows 2000-Kompatibilitätsmodus), wird nur eine Instanz unterstützt, wenn tatsächlich bereits mehrere Instanzen vorhanden sind, verwenden. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da das Herunterfahren der Instanz, die die Sitzung zugeordnet ist. |
Diese Funktion erfolgreich ist, wird die Gruppe von Transaktionsprotokolldateien, die nach dem erfolgreichen Abschluss die aktuelle Sicherung nicht mehr benötigt werden gelöscht. Das Zustandsautomat backup wird vorgezogen werden, so, dass die Sicherungen der Datenbankdateien nicht mehr zulässig ist. Nur Patch-Datenbankdateien und Transaktionsprotokolldateien dürfen für die Sicherung über diesen Punkt hinaus geöffnet werden.
Wenn diese Funktion fehlschlägt, kann das backup Zustandsautomat versetzt werden so, dass die Sicherungen der Datenbankdateien nicht mehr möglich ist. Kann eine Anzahl von Transaktionsprotokolldateien gelöscht werden, die kleiner ist als die gewünschte Anzahl, aber immer gelöscht werden von ALT nach jung.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
"ESENT.dll" erfordert. |
Siehe auch
Extensible Storage Engine-Dateien
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService