JetGetLogInfoInstance2-Funktion

Artikel
06/12/2023

Gilt für: Windows | Windows Server

JetGetLogInfoInstance2-Funktion

Die JetGetLogInfoInstance2-Funktion wird während einer von JetBeginExternalBackup initiierten Sicherung verwendet, um einen instance nach den Namen von Datenbankpatchdateien und Transaktionsprotokolldateien abzufragen, die Teil des Sicherungsdateisatzes werden sollen. Diese Dateien können anschließend mithilfe von JetOpenFile geöffnet und mit JetReadFile gelesen werden.

Windows XP: JetGetLogInfoInstance2 wird in Windows XP eingeführt.

    JET_ERR JET_API JetGetLogInfoInstance2(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual,
      __in_out_opt  JET_LOGINFO* pLogInfo
    );

Parameter

instance

Die für diesen Aufruf zu verwendende instance.

Für Windows 2000 ist die API-Variante, die diesen Parameter akzeptiert, nicht verfügbar, da nur eine instance unterstützt wird. Die Verwendung dieses globalen instance ist in diesem Fall impliziert.

Bei Windows XP und höheren Versionen kann die API-Variante, die diesen Parameter nicht akzeptiert, nur aufgerufen werden, wenn sich das Modul im Legacymodus (Windows 2000-Kompatibilitätsmodus) befindet, in dem nur eine instance unterstützt wird. Andernfalls schlägt der Vorgang mit JET_errRunningInMultiInstanceMode fehl.

szz

Der Ausgabepuffer, der die Liste der null beendeten Zeichenfolgen empfängt, die den Satz von Datenbankpatchdateien und Transaktionsprotokolldateien beschreiben, die Teil des Sicherungsdateisatzes sein sollten.

Die Liste der in diesem Puffer zurückgegebenen Zeichenfolgen hat das gleiche Format wie eine von der Registrierung verwendete Mehrzeichenfolge. Jede null beendete Zeichenfolge wird nacheinander zurückgegeben, gefolgt von einem abschließenden NULL-Abschlussator.

cbMax

Die maximale Größe des Ausgabepuffers in Bytes.

pcbActual

Empfängt die tatsächliche Menge an Zeichenfolgendaten, die im Ausgabepuffer empfangen werden.

pLogInfo

Empfängt strukturierte Informationen zu den Transaktionsprotokolldateien, die Teil des Sicherungsdateisatzes sein sollten.

Wenn dieser Parameter nicht vorhanden ist, wird davon ausgegangen, dass sein Wert NULL ist.

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. Dieser Fehler wird nur von Windows XP und höheren Versionen zurückgegeben.
JET_errClientRequestToStopJetService	Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurden.
JET_errInstanceUnavailable	Es ist nicht möglich, den Vorgang abzuschließen, da beim instance, der 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. Dieser Fehler wird nur von Windows XP und höheren Versionen zurückgegeben.
JET_errInvalidBackupSequence	Fehler beim Sicherungsvorgang, weil er außerhalb der Sequenz aufgerufen wurde. JetGetLogInfo gibt diesen Fehler zurück, wenn ausstehende Dateihandles mit JetOpenFile für die instance erstellt wurden.
JET_errInvalidParameter	Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert oder einen Wert, der in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll war. Dies kann bei JetGetLogInfo passieren, wenn das angegebene instance Handle ungültig ist (Windows XP und höhere Versionen).
JET_errNoBackup	Der Vorgang ist fehlgeschlagen, da keine externe Sicherung ausgeführt wird.
JET_errNotInitialized	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance noch nicht initialisiert wurde.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da auf dem der Sitzung zugeordneten instance ein Wiederherstellungsvorgang ausgeführt wird.
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	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance heruntergefahren wird.

Bei Erfolg werden die angeforderten Informationen zu den Datenbankpatchdateien und Transaktionsprotokolldateien, die Teil des Sicherungsdateisatzes sein sollten, in den Ausgabepuffern platziert, wo angegeben. 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.

Bei einem Fehler ist der Zustand der Ausgabepuffer undefiniert. Der Fehler führt zum Abbruch des gesamten Sicherungsvorgangs für die instance.

Bemerkungen

Beachten Sie, dass diese API keinen Fehler oder eine Warnung zurückgibt, wenn der Ausgabepuffer zu klein ist, um die vollständige Liste der Dateien zu akzeptieren, die Teil des Sicherungsdateisatzes sein sollten. Die Anwendung sollte immer einen Puffer bereitstellen, um die tatsächliche Größe dieser Liste zu empfangen und anhand dieser Informationen zu bestimmen, ob die Liste abgeschnitten wurde.

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.
Unicode	Implementiert als JetGetLogInfoInstance2W (Unicode) und JetGetLogInfoInstance2A (ANSI).

Weitere Informationen

JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup

Freigeben über

JetGetLogInfoInstance2-Funktion