Funzione JetCloseFile

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetCloseFile

La funzione JetCloseFile chiude un file aperto con JetOpenFile dopo l'estrazione dei dati da tale file tramite JetReadFile.

    JET_ERR JET_API JetCloseFile(
      __in          JET_HANDLE hfFile
    );

Parametri

hfFile

Handle del file da leggere.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errClientRequestToStopJetService

Non è possibile completare l'operazione perché tutte le attività nell'istanza associata alla sessione non sono state interrotte in seguito a una chiamata a JetStopService.

JET_errInstanceUnavailable

Non è possibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati.

Questo errore verrà restituito solo da Windows XP e versioni successive.

JET_errInvalidParameter

Uno dei parametri forniti contiene un valore imprevisto o contiene un valore che non ha senso quando si combina con il valore di un altro parametro. Questo può verificarsi per JetCloseFile quando:

  • L'handle di istanza specificato non è valido (Windows XP e versioni successive),

  • L'handle di file specificato non è valido.

JET_errNoBackup

L'operazione non è riuscita perché non è in corso alcun backup esterno.

JET_errNotInitialized

Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.

JET_errRestoreInProgress

Non è possibile completare l'operazione perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.

JET_errRunningInMultiInstanceMode

L'operazione non è riuscita perché è stato effettuato un tentativo di usare il motore in modalità legacy (modalità di compatibilità di Windows 2000) in cui è supportata solo un'istanza quando esistono già più istanze.

JET_errTermInProgress

Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.

In caso di esito positivo, l'handle di file viene chiuso. Se un file di database è stato chiuso, il file di patch del database associato (se presente) viene eliminato.

In caso di errore, non si verifica alcuna modifica.

Commenti

Il motore di database supporta attualmente un solo file aperto tramite JetOpenFile alla volta. Se un handle di file viene aperto usando JetOpenFile , deve essere chiuso usando JetCloseFile prima che sia possibile aprire un altro file.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Vedere anche

JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService