Fonction JetTerm2

S’applique à : Windows | Windows Serveurs

Fonction JetTerm2

La fonction JetTerm2 lance l’arrêt d’une instance qui a été initialisée par JetInit.

JetTerm2 peut également détruire une instance non initialisée qui a été créée par JetCreateInstance.

    JET_ERR JET_API JetTerm2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Paramètres

instancié

Instance à utiliser pour cet appel.

Windows 2000 : Ce paramètre est ignoré et doit toujours avoir la valeur null.

Windows XP et versions ultérieures : Ce paramètre est surchargé. si le moteur fonctionne en mode hérité (Windows mode de compatibilité 2000) alors qu’une seule instance est prise en charge, ce paramètre peut avoir la valeur NULL ou peut contenir l’instance réelle retournée par JetInit. Si le moteur fonctionne en mode multi-instance, ce paramètre doit être un pointeur vers une instance créée à l’aide de JetCreateInstance.

grbit

Groupe de bits qui contiennent les options à utiliser pour cet appel, qui incluent zéro, une ou plusieurs des valeurs suivantes.

Valeur

Signification

JET_bitTermComplete

Demande que l’instance soit arrêtée proprement. Tout travail de nettoyage facultatif qui serait normalement effectué en arrière-plan au moment de l’exécution est immédiatement effectué.

JET_bitTermAbrupt

Demande que l’instance soit arrêtée aussi rapidement que possible. Tout travail facultatif qui serait normalement effectué en arrière-plan au moment de l’exécution est abandonné.

Remarque Cette option peut entraîner une perte d’espace temporaire ou permanente dans la base de données. Cet espace perdu peut toujours être récupéré via une défragmentation hors connexion de la base de données.

JET_bitTermStopBackup

Demande que l’instance soit arrêtée même si une sauvegarde est actuellement en cours. En règle générale, une sauvegarde en attente provoquerait l’échec de JetTerm avec JET_errBackupInProgress. Quand ce paramètre n’est pas présent, sa valeur est supposée être JET_bitTermAbrupt.

JET_bitTermDirty

Demande que l’instance soit arrêtée avec toutes les bases de données attachées laissées dans un état modifié.

Windows 7 : JET_bitTermDirty est introduite dans Windows 7.

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_errBackupInProgress

Impossible de terminer l’opération, car une opération de sauvegarde est en cours sur l’instance.

JET_errInvalidParameter

L’un des paramètres fournis contenait une valeur inattendue ou la combinaison de plusieurs paramètres a généré un résultat inattendu. Cette erreur est retournée par JetTerm lorsque le moteur est en mode multi-instance et lorsque pinstance fait référence à une instance non valide.

Windows XP : cette valeur de retour est introduite dans Windows XP.

JET_errNotInitialized

L’opération ne peut pas se terminer car l’instance n’a pas encore été initialisée.

JET_errTermInProgress

L’opération ne peut pas se terminer car l’instance est en cours d’arrêt.

JET_errRestoreInProgress

Il n’est pas possible de terminer l’opération, car une opération de restauration est en cours sur l’instance.

JET_errTooManyActiveUsers

L’instance ne peut pas être arrêtée, car il existe actuellement des sessions avec des transactions actives pour l’instance spécifiée. Cette erreur se produit uniquement si le JET_bitTermComplete est utilisé.

Si cette fonction est réussie, l’instance spécifiée est arrêtée. Le descripteur d’instance est également fermé et rendu non disponible pour toute API qui accepte un handle d’instance. Tous les autres objets associés à l’instance, tels que les sessions, sont également fermés. L’état du fichier de point de contrôle, des fichiers journaux des transactions et des fichiers de base de données attachés à l’instance sera modifié au cours du processus d’arrêt.

Si cette fonction échoue en raison d’une erreur d’utilisation, l’instance reste dans un état initialisé et rien ne change. Dans le cas contraire, l’instance est toujours arrêtée comme indiqué dans le cas de réussite. La différence est que l’instance doit passer par la récupération après incident lorsqu’elle est ensuite initialisée. Le moteur essaiera de vider le plus de données possible pour réduire la quantité de récupération requise. Conceptuellement, un tel échec de JetTerm n’est pas différent d’un blocage de processus.

Notes

Consultez JetTerm.

Spécifications

Condition requise Valeur

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

fichiers de moteur d’Stockage Extensible
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm