JetGetLogInfo-Funktion
Gilt für: Windows | Windows Server
JetGetLogInfo-Funktion
Die JetGetLogInfo-Funktion wird während einer von JetBeginExternalBackup initiierten Sicherung verwendet, um eine 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 mithilfe von JetReadFile gelesen werden.
JET_ERR JET_API JetGetLogInfo(
__out_opt tchar* szz,
__in unsigned long cbMax,
__out_opt unsigned long* pcbActual
);
Parameter
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 mehrfache Zeichenfolge, die von der Registrierung verwendet wird. Jede mit NULL beendete Zeichenfolge wird nacheinander zurückgegeben, gefolgt von einem endgültigen NULL-Abschlusszeichen.
cbMax
Die maximale Größe des Ausgabepuffers in Byte.
pcbActual
Empfängt die tatsächliche Menge der im Ausgabepuffer empfangenen Zeichenfolgendaten.
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 |
Der Vorgang ist fehlgeschlagen, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackup abgebrochen wurde. Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben. |
JET_errClientRequestToStopJetService |
Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf der 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 für die instance, die 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 späteren Versionen zurückgegeben. |
JET_errInvalidBackupSequence |
Fehler beim Sicherungsvorgang, weil er außerhalb der Reihenfolge 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 der Fall sein, wenn das angegebene instance Handle ungültig ist (Windows XP und höhere Versionen). |
JET_errNoBackup |
Der Vorgang ist fehlgeschlagen, weil 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 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 |
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 sollen, in den Ausgabepuffern platziert, sofern angegeben. 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.
Bei einem Fehler ist der Zustand der Ausgabepuffer nicht definiert. 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 erhalten, und diese Informationen verwenden, um zu bestimmen, ob die Liste abgeschnitten wurde.
Anforderungen
Anforderung | Wert |
---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Kopfzeile |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Unicode |
Implementiert als JetGetLogInfoW (Unicode) und JetGetLogInfoA (ANSI). |
Weitere Informationen
JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup