Fonction JetDupSession

S’applique à : Windows | Windows Server

Fonction JetDupSession

La fonction JetDupSession démarre une session, initialise et retourne un handle de session ESE (JET_SESID). Les sessions contrôlent tous les accès à la base de données et sont utilisées pour contrôler l’étendue des transactions. La session peut être utilisée pour démarrer, valider ou annuler des transactions. La session est également utilisée pour attacher, créer ou ouvrir une base de données. La session est utilisée comme contexte pour toutes les opérations DDL et DML. Pour augmenter la concurrence et l’accès parallèle à la base de données, plusieurs sessions peuvent être démarrées.

Note Cette API agit de toutes les manières en tant que JetBeginSession appelée sur le instance de la session passée. Cette fonction n’est pas recommandée. JetBeginSession est préférable.

    JET_ERR JET_API JetDupSession(
      __in          JET_SESID sesid,
      __out         JET_SESID* psesid
    );

Paramètres

sesid

Session à utiliser comme source pour la duplication ou le début de la session.

psesid

Pointeur vers la variable que la session gère initialise en cas de retour réussi.

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.
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_errOutOfSessions	Le nombre de sessions que le moteur permet au client de démarrer est limité. Cette valeur peut être modifiée à l’aide de JetSetSystemParameter avec la constante JET_paramMaxSessions . Le nombre de sessions par défaut est de 16. Pour plus d’informations sur JET_paramMaxSessions, consultez Paramètres système.
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 initialisé et peut être utilisé pour les opérations de base de données.

En cas d’échec, aucune session n’est disponible ou une nouvelle session n’a pas pu être initialisée.

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_SESID
JetBeginSession
JetSetSystemParameter
JetStopService
Paramètres système