JetCloseFile fonction)
S’applique à : Windows | Windows Serveurs
JetCloseFile fonction)
La fonction JetCloseFile ferme un fichier ouvert avec JetOpenFile une fois 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 de terminer l’opération, car toute activité sur l’instance associée à la session a été interrompue suite à un appel à JetStopService. |
JET_errInstanceUnavailable |
Il n’est pas possible de terminer l’opération, car l’instance associée à la session a rencontré une erreur irrécupérable qui requiert que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données. cette erreur est renvoyé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’a pas de sens lorsqu’elle était associée à la valeur d’un autre paramètre. Cela peut se produire pour JetCloseFile dans les cas suivants :
|
JET_errNoBackup |
L’opération a échoué, car aucune sauvegarde externe n’est en cours. |
JET_errNotInitialized |
Impossible de terminer l’opération, car l’instance associée à la session n’a pas encore été initialisée. |
JET_errRestoreInProgress |
Il n’est pas possible de terminer l’opération, car une opération de restauration est en cours sur l’instance associée à la session. |
JET_errRunningInMultiInstanceMode |
l’opération a échoué en raison d’une tentative d’utilisation du moteur en mode hérité (Windows mode de compatibilité 2000), où une seule instance est prise en charge lorsqu’il existe déjà plusieurs instances. |
JET_errTermInProgress |
Il n’est pas possible de terminer l’opération, car l’instance associée à la session est en cours d’arrêt. |
En cas de réussite, le descripteur 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.
Remarques
Le moteur de base de données ne prend actuellement en charge qu’un seul fichier ouvert via JetOpenFile à la fois. Si un descripteur de fichier est ouvert à l’aide de JetOpenFile , il doit être fermé à l’aide de JetCloseFile pour pouvoir ouvrir un autre fichier.
Configuration requise
| | |
Client
|requiert Windows Vista, Windows XP ou Windows 2000 Professional.
| |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
|Requiert ESENT.dll.
|Voir aussi
JET_ERR
JET_INSTANCE
JET_HANDLE
JetOpenFile
JetReadFile
JetStopService