JetCloseFileInstance-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetCloseFileInstance-Funktion

Die JetCloseFileInstance-Funktion schließt eine Datei, die mit JetOpenFileInstance geöffnet wurde, nachdem die Daten aus dieser Datei mithilfe von JetReadFileInstance extrahiert wurden.

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

    JET_ERR JET_API JetCloseFileInstance(
      __in          JET_INSTANCE instance,
      __in          JET_HANDLE hfFile
    );

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.

hfFile

Das Handle der zu lesenden Datei.

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_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 JetStopServiceInstance 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_errInvalidParameter

Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameterwerte ergab ein unerwartetes Ergebnis. Dies kann für JetCloseFileInstance in folgenden Fällen auftreten:

  • Das angegebene instance Handle ist ungültig (Windows XP und höhere Versionen)

  • Das angegebene Dateihandle ist ungültig.

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 wird das Dateihandle geschlossen. Wenn eine Datenbankdatei geschlossen wurde, wird die zugehörige Datenbankpatchdatei (falls vorhanden) zerstört.

Bei einem Fehler tritt keine Änderung auf.

Bemerkungen

Die Datenbank-Engine unterstützt derzeit nur eine geöffnete Datei über JetOpenFileInstance gleichzeitig. Wenn ein Dateihandle mit JetOpenFileInstance geöffnet wird, muss es mit JetCloseFileInstance geschlossen werden, bevor eine andere Datei geöffnet werden kann.

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.

Weitere Informationen

JET_ERR
JET_HANDLE
JET_INSTANCE
JetOpenFileInstance
JetReadFileInstance
JetStopServiceInstance