Fonction JetStopService

S’applique à : Windows | Windows Serveurs

Fonction JetStopService

La fonction JetStopService prépare une instance pour l’arrêt.

JetStopService est l’appel hérité lorsqu’une seule instance est autorisée. Dans ce cas, la seule instance active est celle qui est préparée pour l’arrêt.

    JET_ERR JET_API JetStopService(void);

Paramètres

Cette fonction n’a pas de paramètres.

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_errRunningInMultiInstanceMode

Il n’est pas évident de déterminer l’instance à préparer pour l’arrêt lors de l’utilisation de JetStopService avec plusieurs modes d’instance.

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

Si cette fonction est réussie, elle se prépare à un arrêt ultérieur. Les étapes à suivre pour préparer un arrêt sont les suivantes :

  • Arrêtez la défragmentation en ligne si elle est en cours d’exécution.

  • Démarrez un nettoyage de la Banque des versions.

  • Réduisez la profondeur du point de contrôle en commençant à vider les pages incorrectes dans le gestionnaire de tampons.

  • Empêcher les appels ultérieurs à la plupart des fonctions pour cette instance.

Si cette fonction échoue, aucune des étapes de préparation d’un arrêt de l’instance n’est effectuée, donc aucune modification de l’état de l’instance ne se produit.

Notes

Cette fonction réduit le travail que l’instance doit effectuer une fois qu’elle est terminée, mais ne met pas fin à l’instance. Par conséquent, cette fonction est simplement une optimisation et n’est pas obligatoire pour l’utilisation. notez que la quantité de travail effectuée en préparation était moindre dans Windows 2000 et Windows XP. Une fois la fonction réussie, l’appel de fonctions qui ne sont plus autorisées retourne JET_errClientRequestToStopJetService. Les fonctions qui sont toujours autorisées après cet appel sont les suivantes : JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase et JetResetSessionContext.

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

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2