Fonction JetStopService
S’applique à : Windows | Windows Server
Fonction JetStopService
La fonction JetStopService prépare un instance pour l’arrêt.
JetStopService est l’appel hérité quand un seul instance est autorisé. Dans ce cas, la seule instance active est celle en cours de préparation à 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 clair quelle instance préparer l’arrêt lors de l’utilisation de JetStopService avec plusieurs instance mode. Windows XP : Cette valeur de retour est introduite dans Windows XP. |
Si cette fonction réussit, elle se prépare à un arrêt ultérieur. Les étapes prises pour se 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 magasin de versions propre-up.
Réduisez la profondeur du point de contrôle en commençant à vider sale pages dans le gestionnaire de mémoires tampons.
Empêchez les appels futurs à la plupart des fonctions pour ce instance.
Si cette fonction échoue, aucune des étapes de préparation à un arrêt de instance n’est effectuée, de sorte qu’aucune modification de l’état instance n’est effectuée.
Notes
Cette fonction réduit le travail que le instance devra effectuer à l’arrêt, mais n’arrêtera pas le 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 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 : JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase et JetResetSessionContext.
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_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2