JetGetAttachInfo-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetGetAttachInfo-Funktion

Die JetGetAttachInfo-Funktion wird während einer von JetBeginExternalBackup initiierten Sicherung verwendet, um eine instance nach den Namen der Datenbankdateien abzufragen, die Teil des Sicherungsdateisatzes werden sollen. Es werden nur Datenbanken berücksichtigt, die derzeit mit JetAttachDatabase an den instance angefügt sind. Diese Dateien können anschließend mithilfe von JetOpenFile geöffnet und mit JetReadFile gelesen werden.

    JET_ERR JET_API JetGetAttachInfo(
      __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 Datenbankdateien 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-Zeichenfolge wird nacheinander zurückgegeben, gefolgt von einem abschließenden NULL-Abschlussator.

cbMax

Die maximale Größe des Ausgabepuffers in Bytes.

pcbActual

Zeiger auf den Ausgabepuffer, der die tatsächliche Menge an Zeichenfolgendaten empfangen hat.

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. JetGetAttachInfo gibt diesen Fehler zurück, wenn die aktuelle Sicherung keine vollständige Sicherung ist.

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 für JetGetAttachInfo auftreten, 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 für den Satz von Datenbankdateien, die Teil des Sicherungsdateisatzes sein sollen, in den Ausgabepuffern platziert, wo angegeben.

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, 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 JetGetAttachInfoW (Unicode) und JetGetAttachInfoA (ANSI).

Weitere Informationen

JET_ERR
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService