Partager via

Fonction JetCloseFile

  • Article

S’applique à : Windows | Windows Server

Fonction JetCloseFile

La fonction JetCloseFile ferme un fichier qui a été ouvert avec JetOpenFile après que les données de ce fichier ont été extraites à l’aide de JetReadFile.

    JET_ERR JET_API JetCloseFile(
      __in          JET_HANDLE hfFile
    );

Paramètres

hfFile

Handle du fichier à lire.

Valeur renvoyée

Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur de stockage extensible et Paramètres de gestion des erreurs.

Code de retour

Description

JET_errSuccess

L’opération s’est terminée avec succès.

JET_errClientRequestToStopJetService

Il n’est pas possible d’effectuer l’opération, car toutes les activités sur le instance associées à la session ont cessé à la suite d’un appel à JetStopService.

JET_errInstanceUnavailable

Il n’est pas possible d’effectuer l’opération, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données.

Cette erreur sera retournée uniquement par Windows XP et les versions ultérieures.

JET_errInvalidParameter

L’un des paramètres fournis contenait une valeur inattendue ou contenait une valeur qui n’était pas logique lorsqu’elle était combinée à la valeur d’un autre paramètre. Cela peut se produire pour JetCloseFile lorsque :

  • Le handle de instance spécifié n’est pas valide (Windows XP et versions ultérieures),

  • Le handle de fichier spécifié n’est pas valide.

JET_errNoBackup

L’opération a échoué, car aucune sauvegarde externe n’est en cours.

JET_errNotInitialized

Il n’est pas possible d’effectuer l’opération, car le instance associé à la session n’a pas encore été initialisé.

JET_errRestoreInProgress

Il n’est pas possible d’effectuer l’opération, car une opération de restauration est en cours sur le instance associé à la session.

JET_errRunningInMultiInstanceMode

L’opération a échoué car une tentative d’utilisation du moteur a été effectuée en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge alors qu’en fait plusieurs instances existent déjà.

JET_errTermInProgress

Il n’est pas possible d’effectuer l’opération, car le instance associé à la session est en cours d’arrêt.

En cas de réussite, le handle de fichier est fermé. Si un fichier de base de données a été fermé, le fichier correctif de base de données associé (le cas échéant) est détruit.

En cas d’échec, aucune modification ne se produit.

Notes

Le moteur de base de données ne prend actuellement en charge qu’un seul fichier ouvert via JetOpenFile à la fois. Si un handle de fichier est ouvert à l’aide de JetOpenFile , il doit être fermé à l’aide de JetCloseFile pour qu’un autre fichier puisse être ouvert.

Spécifications

Condition requise Valeur

Client

Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.

Serveur

Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.

En-tête

Déclaré dans Esent.h.

Bibliothèque

Utilisez ESENT.lib.

DLL

Nécessite ESENT.dll.

Voir aussi

JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService