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