JetCloseFile-Funktion
Gilt für: Windows | Windows Server
JetCloseFile-Funktion
Die JetCloseFile-Funktion schließt eine Datei, die mit JetOpenFile geöffnet wurde, nachdem die Daten aus dieser Datei mithilfe von JetReadFile extrahiert wurden.
JET_ERR JET_API JetCloseFile(
__in JET_HANDLE hfFile
);
Parameter
hfFile
Das Handle der zu lesenden Datei.
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_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_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 JetCloseFile in folgenden Fällen der Fall sein:
|
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 erfolgreicher Ausführung 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 JetOpenFile gleichzeitig. Wenn ein Dateihandle mit JetOpenFile geöffnet wird, muss es mit JetCloseFile geschlossen werden, bevor eine andere Datei geöffnet werden kann.
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. |
Weitere Informationen
JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService