JetCloseFile-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetCloseFile-Funktion
Die Funktion JetCloseFile schließt eine Datei, die mit JetOpenFile geöffnet wurde, nachdem die Daten aus dieser Datei mit JetReadFileextrahiert wurden.
JET_ERR JET_API JetCloseFile(
__in JET_HANDLE hfFile
);
Parameter
hfFile
Das Handle der Datei gelesen werden sollen.
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
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 die Instanz der Sitzung zugeordnet aufgrund eines Aufrufs von JetStopServicebehoben ist. |
JET_errInstanceUnavailable |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet ein schwerwiegender Fehler, der erforderlich sind aufgetreten wurde, 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ätere Versionen zurückgegeben werden. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter einen unerwarteten Wert oder oder enthalten ein Werts, das nicht mit dem Wert eines anderen Parameters kombiniert keinen Sinn. Dies kann vorkommen, für JetCloseFile wenn:
|
JET_errNoBackup |
Der Vorgang fehlgeschlagen ist, weil keine externen Sicherung ausgeführt wird. |
JET_errNotInitialized |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet wurde noch nicht initialisiert. |
JET_errRestoreInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da ein Restore-Vorgang in Arbeit auf die Instanz der Sitzung zugeordnet ist. |
JET_errRunningInMultiInstanceMode |
Der Vorgang ist fehlgeschlagen, da versucht wurde, verwenden Sie das Modul im legacy-Modus (Windows 2000-Kompatibilitätsmodus), in denen wird nur eine einzige Instanz unterstützt, wenn mehrere Instanzen tatsächlich bereits vorhanden sein. |
JET_errTermInProgress |
Es ist nicht möglich, den Vorgang abzuschließen, da die Instanz der Sitzung zugeordnet heruntergefahren wird. |
Klicken Sie auf Erfolg wird das Dateihandle geschlossen. Eine Datenbankdatei geschlossen wurde wird die zugeordnete Datenbank Patch-Datei (falls vorhanden) gelöscht.
Bei einem Fehler tritt auf, keine Änderung.
Anmerkungen
Die Datenbank-Engine unterstützt derzeit nur über JetOpenFile einer geöffneten Datei zu einem Zeitpunkt. Wenn ein Dateihandle mit JetOpenFile geöffnet muss es geschlossen JetCloseFile verwenden, bevor eine andere Datei geöffnet werden kann.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server benötigt. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Siehe auch
JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService