Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetGetLogInfoInstance2-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

Die JetGetLogInfoInstance2 -Funktion wird verwendet, während einer Sicherung, die durch JetBeginExternalBackup initiiert Abfragen eine Instanz für die Namen von Patch-Datenbankdateien und Transaktionsprotokolldateien, die die backup-Datei übernommen werden sollen. Diese Dateien können anschließend geöffnet werden, mithilfe von JetOpenFile und JetReadFilemit gelesen.

Windows XP: JetGetLogInfoInstance2 ist 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 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äteren Versionen kann API-Variante, die diesen Parameter nicht akzeptiert nur aufgerufen werden, wenn die Engine im legacy-Modus (Windows 2000-Kompatibilitätsmodus) ist, in dem nur eine einzige Instanz unterstützt. Andernfalls wird der Vorgang mit JET_errRunningInMultiInstanceMode fehl.

Verband

Legen Sie den Ausgabepuffer, die die Liste der null beendete Zeichenfolgen beschreiben die Patch-Datenbankdateien erhalten und Transaktionsprotokolldateien, die in der Sicherungsdatei enthalten sein sollten.

Die Liste der Zeichenfolgen in diesem Puffer zurückgegeben wird in demselben Format wie eine mehrteilige Zeichenfolge von der Registrierung verwendet. Jeder null beendete Zeichenfolge wird in der Sequenz gefolgt von einer endgültigen Nullabschlusszeichen zurückgegeben.

cbMax

Die maximale Größe des Ausgabepuffers in Bytes.

pcbActual

Empfängt die tatsächliche Zeichenfolge empfangene Datenmenge in den Ausgabepuffer.

pLogInfo

Empfängt strukturierten Informationen in die Transaktionsprotokolldateien, die in der backup-Dateisatz enthalten sein sollten.

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

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. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben werden.

JET_errClientRequestToStopJetService

Es ist nicht möglich, um den Vorgang abzuschließen, da alle Aktivitäten in der Instanz dieser Sitzung aufgrund eines Aufrufs von JetStopServiceeingestellt hat.

JET_errInstanceUnavailable

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz ein schwerwiegender Fehler, der erfordert aufgetreten ist, 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äteren Versionen zurückgegeben werden.

JET_errInvalidBackupSequence

Der Sicherungsvorgang ist fehlgeschlagen, da sie außerhalb der Reihenfolge aufgerufen wurde. JetGetLogInfo gibt diesen Fehler zurück, wenn gibt es ausstehenden Dateihandles mit JetOpenFile für die Instanz erstellt wurde.

JET_errInvalidParameter

Einer der bereitgestellten Parameter einen unerwarteten Wert enthalten oder enthalten einen Wert, der nicht mit dem Wert eines anderen Parameters kombiniert keinen Sinn. Dies kann für JetGetLogInfo passieren, wenn das angegebene Instanzhandle ungültig ist (Windows XP und späteren Versionen).

JET_errNoBackup

Der Vorgang ist fehlgeschlagen, da keine externe Sicherung ausgeführt wird.

JET_errNotInitialized

Es ist nicht möglich, um den Vorgang abzuschließen, da die Instanz dieser Sitzung noch nicht initialisiert wurde.

JET_errRestoreInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da ein Wiederherstellungsvorgang ausgeführt auf die Instanz der Sitzung zugeordnet wird.

JET_errRunningInMultiInstanceMode

Der Vorgang ist fehlgeschlagen, da versucht wurde, verwenden Sie die Engine im legacy-Modus (Windows 2000-Kompatibilitätsmodus), wird nur eine einzige Instanz unterstützt, wenn tatsächlich mehrere Instanzen vorhanden.

JET_errTermInProgress

Es ist nicht möglich, um den Vorgang abzuschließen, da die Sitzung zugeordnete Instanz heruntergefahren wird.

Bei Erfolg werden die angeforderte Informationen auf den Satz von Patch-Datenbankdateien und Transaktionsprotokolldateien, die backup-Dateisatz enthalten sollte in die Ausgabe eingefügt puffert, soweit vorgesehen. 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.

Bei einem Fehler ist der Zustand der Ausgabepuffer nicht definiert. Der Fehler führt zu den Abbruch der gesamten backup-Prozess für die Instanz.

Anmerkungen

Es ist wichtig zu beachten, dass diese API nicht liefert einen Fehler oder eine Warnung, wenn der Ausgabepuffer ist zu klein, um die vollständige Liste der Dateien zu akzeptieren, die backup-Dateisatz enthalten sollte. Die Anwendung sollte immer bieten einen Puffer, um die tatsächliche Größe der Liste empfangen und diese Informationen verwenden, um festzustellen, ob die Liste abgeschnitten wurde.

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

"ESENT.dll" erfordert.

Unicode

Implementiert als JetGetLogInfoInstance2W (Unicode) und JetGetLogInfoInstance2A (ANSI).

Siehe auch

Anzeigen:
© 2015 Microsoft