JetGetAttachInfo-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetGetAttachInfo-Funktion
Die JetGetAttachInfo -Funktion wird verwendet, während einer Sicherung, die durch JetBeginExternalBackup initiiert eine Instanz für die Namen der Datenbankdateien Abfragen, die die backup-Datei übernommen werden sollen. Nur Datenbanken der Instanz mit der JetAttachDatabase verbundene werden berücksichtigt. Diese Dateien können anschließend geöffnet werden, mithilfe von JetOpenFile und JetReadFilemit gelesen.
JET_ERR JET_API JetGetAttachInfo(
__out_opt tchar* szz,
__in unsigned long cbMax,
__out_opt unsigned long* pcbActual
);
Parameter
Verband
Der Ausgabepuffer, der empfängt die Liste mit null beendete Zeichenfolgen beschreiben die Datenbankdateien, die in der backup-Dateisatz enthalten sein sollten. Die Liste der Zeichenfolgen in diesem Puffer zurückgegeben wird in demselben Format wie eine mehrteilige Zeichenfolge von der Registrierung verwendet. Jede Zeichenfolge mit Nullabschlusszeichen wird in der Sequenz gefolgt von einer endgültigen Nullabschlusszeichen zurückgegeben.
cbMax
Die maximale Größe des Ausgabepuffers in Bytes.
pcbActual
Zeiger auf den Ausgabepuffer, der die tatsächliche Datenmenge Zeichenfolge empfangen.
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. JetGetAttachInfo gibt diesen Fehler zurück, wenn die aktuelle Sicherung keine vollständige Sicherung ist. |
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 JetGetAttachInfo 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 puffert die angeforderte Informationen auf Datenbanken, Dateien, die Teil der backup-Datei sollte in der Ausgabe platziert werden wo vorausgesetzt.
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, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
"ESENT.dll" erfordert. |
Unicode |
Implementiert als JetGetAttachInfoW (Unicode) und JetGetAttachInfoA (ANSI). |
Siehe auch
JET_ERR
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService