JetTruncateLogInstance-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetTruncateLogInstance-Funktion
Die Funktion JetTruncateLogInstance wird während einer Sicherung von JetBeginExternalBackup initiiert wurde verwendet, um Transaktionsprotokolldateien zu löschen, die nicht mehr benötigt wird, nachdem die aktuelle Sicherung erfolgreich abgeschlossen wurde.
Windows XP: JetTruncateLogInstance wird in Windows XP eingeführt.
JET_ERR JET_API JetTruncateLogInstance(
__in JET_INSTANCE instance
);
Parameter
Instance
Die Instanz, die für diesen Aufruf verwenden.
Für Windows 2000 ist die API-Variante, die für diesen Parameter kann nicht verfügbar, da nur eine einzige Instanz unterstützt wird. In diesem Fall wird die Verwendung dieser eine globale Instanz impliziert.
Für Windows XP und spätere Versionen kann die API-Variante, die keine dieser Parameter akzeptiert nur aufgerufen werden, wenn das Modul im legacy-Modus (Windows 2000-Kompatibilitätsmodus) ist, in denen nur eine einzige Instanz unterstützt. Andernfalls wird der Vorgang mit JET_errRunningInMultiInstanceMode fehl.
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errBackupAbortByServer |
WindowsServer 2003: Dieser Wert wird in Windows Server 2003 eingeführt. Der Vorgang fehlgeschlagen ist, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf die Instanz, die die Sitzung zugeordnet ist aufgrund eines Aufrufs von JetStopServicebehoben ist. |
JET_errInstanceUnavailable |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist, ein schwerwiegender Fehler, der erforderlich sind aufgetreten, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden. |
JET_errInvalidBackupSequence |
Fehler beim Sicherungsvorgang, da sie außerhalb der Reihenfolge aufgerufen wurde. JetTruncateLog zurück dieser Fehler, wenn es sind alle ausstehenden Dateikennungen, die mit JetOpenFile für die Instanz erstellt wurden. |
JET_errInvalidParameter |
Einen Parameter, der bereitgestellt wurde, die einen unerwarteten Wert enthalten sind, oder die Kombination aus mehreren Parametern ein unerwartetes Ergebnis zurückgegeben. Dies kann für JetTruncateLog auftreten, wenn das angegebene Instanzenhandle ungültig ist. |
JET_errNoBackup |
Der Vorgang fehlgeschlagen ist, weil keine externen Sicherung ausgeführt wird. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da eine Wiederherstellung ausgeführt auf die Instanz wird, der die Sitzung zugeordnet ist. |
JET_errRunningInMultiInstanceMode |
Der Vorgang ist fehlgeschlagen, da versucht wurde, verwenden Sie das Modul im legacy-Modus (Windows 2000-Kompatibilitätsmodus), in denen wird nur eine einzige Instanz unterstützt, wenn mehrere Instanzen tatsächlich bereits vorhanden sein. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist Herunterfahren. |
Wenn diese Funktion erfolgreich ist, wird der Satz von Transaktionsprotokolldateien, die nicht mehr benötigt wird, nachdem die aktuelle Sicherung erfolgreich abgeschlossen wurde gelöscht. So, dass die Sicherung der Datenbankdateien nicht mehr zulässig ist, wird das backup Zustandsautomat erweitert werden. Nur Patch-Datenbankdateien und Transaktionsprotokolldateien sind für die Sicherung über diesen Punkt hinaus geöffnet werden kann.
Wenn diese Funktion ein Fehler auftritt, kann das Sicherung Zustandsautomat erweitert werden so, dass die Sicherung der Datenbankdateien nicht mehr zulässig ist. Größeren Anzahl von Transaktionsprotokolldateien möglicherweise gelöscht, die kleiner als die gewünschte Anzahl ist, aber immer gelöscht werden vom ältesten zum jüngsten.
Voraussetzungen
-Client, |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert WindowsServer 2008 oder WindowsServer 2003. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Siehe auch
Extensible Storage Engine Dateien
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService