JetGetLogInfo-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetLogInfo-Funktion
Die Funktion JetGetLogInfo wird während einer Sicherung von JetBeginExternalBackup initiiert Abfragen eine Instanz für die Namen der Patch-Datenbankdateien und Transaktionsprotokolldateien, die Teil der Sicherungsdatei werden sollen. Diese Dateien können mithilfe von JetOpenFile und Lesen von JetReadFileanschließend geöffnet werden.
JET_ERR JET_API JetGetLogInfo(
__out_opt tchar* szz,
__in unsigned long cbMax,
__out_opt unsigned long* pcbActual
);
Parameter
Szz
Festlegen der Ausgabepuffer, die die Liste der beendeten null-Zeichenfolgen, die den Satz von Datenbankdateien Patch beschreibt entgegennimmt und Transaktionsprotokolldateien, die ein Teil der Sicherungsdatei sein sollte.
Die Liste der Zeichenfolgen, die in dieser Puffer zurückgegeben wird in demselben Format wie eine mehrteilige Zeichenfolge von der Registrierung verwendet. Jede beendeten null-Zeichenfolge wird in der Sequenz gefolgt von einer endgültigen null-Terminator zurückgegeben.
cbMax
Die maximale Größe in Bytes den Ausgabepuffer.
pcbActual
Empfängt die tatsächliche Vergrößerung Zeichenfolgedaten gültig in den Ausgabepuffer empfangen.
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 |
Der Vorgang fehlgeschlagen ist, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen wurde. Dieser Fehler wird nur von Windows XP und spätere Versionen zurückgegeben werden. |
JET_errClientRequestToStopJetService |
Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf die Instanz der Sitzung zugeordnet aufgrund eines Aufrufs von JetStopServicebehoben ist. |
JET_errInstanceUnavailable |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet ein schwerwiegender Fehler, der erforderlich sind aufgetreten wurde, 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. JetGetLogInfo zurück dieser Fehler, wenn es sind alle ausstehenden Dateikennungen mit JetOpenFile für die Instanz erstellt. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter einen unerwarteten Wert oder oder enthalten ein Werts, das nicht mit dem Wert eines anderen Parameters kombiniert keinen Sinn. Dies kann für JetGetLogInfo auftreten, wenn das angegebene Instanzenhandle ungültig ist (Windows XP und spätere Versionen). |
JET_errNoBackup |
Der Vorgang fehlgeschlagen ist, weil keine externen Sicherung ausgeführt wird. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert. |
JET_errRestoreInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da ein Restore-Vorgang in Arbeit auf die Instanz der 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 |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet heruntergefahren wird. |
Bei Erfolg die angeforderte Informationen auf den Satz von Patch-Datenbankdateien und Transaktionsprotokolldateien, die Teil der Sicherungsdatei sein sollten in der Ausgabe platziert werden Puffern, sofern. 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.
Bei einem Fehler ist der Status der Ausgabepuffer nicht definiert. Der Ausfall führt den Abbruch des gesamten Sicherungsvorgangs für die Instanz.
Anmerkungen
Es ist wichtig, beachten Sie, dass diese API nicht zurückgegeben wird, ein Fehler oder eine Warnung, wenn der Ausgabepuffer ist zu klein, um die vollständige Liste der Dateien zu akzeptieren, die Teil der Sicherungsdatei werden soll. Die Anwendung sollte immer bieten einen Puffer zum Empfangen der tatsächlichen Größe der diese Liste und diese Informationen verwenden, um festzustellen, ob die Liste abgeschnitten wurden.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Unicode |
Implementiert als JetGetLogInfoW (Unicode) und JetGetLogInfoA (ANSI). |
Siehe auch
JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup