JetTruncateLogInstance-Funktion
Gilt für: Windows | Windows Server
JetTruncateLogInstance-Funktion
Die JetTruncateLogInstance-Funktion wird während einer von JetBeginExternalBackup initiierten Sicherung verwendet, um alle Transaktionsprotokolldateien zu löschen, die nach erfolgreichem Abschluss der aktuellen Sicherung nicht mehr benötigt werden.
Windows XP:JetTruncateLogInstance wird in Windows XP eingeführt.
JET_ERR JET_API JetTruncateLogInstance(
__in JET_INSTANCE instance
);
Parameter
instance
Die instance, die für diesen Aufruf verwendet werden soll.
Für Windows 2000 ist die API-Variante, die diesen Parameter akzeptiert, nicht verfügbar, da nur eine instance unterstützt wird. Die Verwendung dieser einen globalen instance ist in diesem Fall impliziert.
Für Windows XP und höhere Versionen kann die API-Variante, die diesen Parameter nicht akzeptiert, nur aufgerufen werden, wenn sich die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) befindet, in dem nur eine instance unterstützt wird. Andernfalls schlägt der Vorgang mit JET_errRunningInMultiInstanceMode fehl.
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_errBackupAbortByServer |
Windows Server 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt. Der Vorgang ist fehlgeschlagen, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackup abgebrochen wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der instance, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopService beendet wurden. |
JET_errInstanceUnavailable |
Der Vorgang kann nicht abgeschlossen werden, da für die instance, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen werden muss, um die Integrität dieser Daten zu schützen. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. |
JET_errInvalidBackupSequence |
Fehler beim Sicherungsvorgang, weil er außerhalb der Reihenfolge 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 führte zu einem unerwarteten Ergebnis. Dies kann bei JetTruncateLog passieren, wenn das angegebene instance Handle ungültig ist. |
JET_errNoBackup |
Der Vorgang ist fehlgeschlagen, weil keine externe Sicherung ausgeführt wird. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete instance 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 bereits mehrere Instanzen vorhanden sind. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete instance 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 Zeitpunkt 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 bis zur jüngsten gelöscht.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert Windows Server 2008 oder Windows Server 2003. |
Kopfzeile |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
Erweiterbare Speicher-Engine-Dateien
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService