Fonction JetStopService

S’applique à : Windows | serveur Windows

Fonction JetStopService

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

JetStopService est l’appel hérité quand 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 de retour

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 extensible Stockage s etparamè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 clair quelle instance préparer pour la fin 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 réussit, elle se prépare à une fin future. Les étapes prises 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 du magasin de versions.

  • Réduisez la profondeur du point de contrôle en commençant à vider les pages sales dans le gestionnaire de mémoire tampon.

  • Empêchez les appels futurs à la plupart des fonctions de cette instance.

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

Notes

Cette fonction réduit le travail que l’instance doit effectuer lors de l’arrêt, mais ne met pas fin à l’instance. Par conséquent, cette fonction n’est qu’une optimisation et n’est pas obligatoire à utiliser. Notez que la quantité de travail effectuée en préparation était inférieure à Windows 2000 et Windows XP. Une fois la fonction réussie, les fonctions appelantes qui ne sont plus autorisées retournent JET_errClientRequestToStopJetService. Les fonctions qui sont toujours autorisées après cet appel sont : JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase et JetResetSessionContext.

Spécifications

Condition requise Valeur

Client

Nécessite 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

Nécessite ESENT.dll.

Voir aussi

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2