Fonction JetStopService

  • Article

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