Fonction JetCloseFileInstance

S’applique à : Windows | Windows Server

Fonction JetCloseFileInstance

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

Windows XP : JetCloseFileInstance est introduit dans Windows XP.

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

Paramètres

instance

Instance à utiliser pour cet appel.

Pour Windows 2000, la variante d’API qui accepte ce paramètre n’est pas disponible, car une seule instance est prise en charge. L’utilisation de cette instance globale est implicite dans ce cas.

Pour Windows XP et les versions ultérieures, la variante d’API qui n’accepte pas ce paramètre ne peut être appelée que lorsque le moteur est en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge. Sinon, l’opération échoue avec JET_errRunningInMultiInstanceMode.

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 toute activité sur le instance associée à la session a cessé à la suite d’un appel à JetStopServiceInstance.
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 nécessite 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 la combinaison de plusieurs valeurs de paramètre a produit un résultat inattendu. Cela peut se produire pour JetCloseFileInstance dans les cas suivants : 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’il existe déjà plusieurs instances.
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 JetOpenFileInstance à la fois. Si un handle de fichier est ouvert à l’aide de JetOpenFileInstance , il doit être fermé à l’aide de JetCloseFileInstance avant qu’un autre fichier puisse être ouvert.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista ou Windows XP.
Serveur	Nécessite Windows Server 2008 ou Windows Server 2003.
En-tête	Déclaré dans Esent.h.
Bibliothèque	Utilisez ESENT.lib.
DLL	Nécessite ESENT.dll.

Voir aussi

JET_ERR
JET_HANDLE
JET_INSTANCE
JetOpenFileInstance
JetReadFileInstance
JetStopServiceInstance