Fonction JetEndSession

Article
06/12/2023

S’applique à : Windows | Windows Server

Fonction JetEndSession

La fonction JetEndSession met fin à la session, nettoie et libère toutes les ressources associées à la session spécifiée.

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Paramètres

sesid

Session à terminer. Les ressources associées sont libérées à la fin de la session.

grbit

Réservé. Ce paramètre peut contenir l’indicateur JET_bitForceSessionClosed, mais cet indicateur est réservé et sa définition n’a aucun effet.

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ée à la session ont cessé à la suite d’un appel à JetStopService.
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.
JET_errInvalidSesid	La session n’était pas une session JET valide.
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_errOutOfMemory	L’opération a échoué, car la mémoire n’a pas pu être allouée.
JET_errSessionInUse	Cela signifie que la session a été utilisée sur un autre thread, ou que la session n’a pas été définie ou réinitialisée correctement.
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_errOutOfBuffers	Erreur système indiquant qu’il n’y a plus de mémoires tampons.
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_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 session est fermé et indisponible, et toutes les ressources associées à cette session sont nettoyées.

En cas d’échec, plusieurs erreurs supplémentaires peuvent se produire dans le cadre de la fermeture de la table de tri, de la fermeture du curseur et de la restauration des transactions. Ces erreurs sont assez peu probables et extrêmement peu probables si vos sessions ne sont pas complètement en cours d’utilisation lorsque JetEndSession est appelé. Ces erreurs sont retournées si une partie de la session n’a pas pu être nettoyée correctement.

Notes

Cette API restaure toutes les transactions ouvertes (non validées au niveau 0). En outre, tous les curseurs associés à cette session et toutes les tables de tri qui ont été créées ou ouvertes seront nettoyés.

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_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService

Fonction JetEndSession