Fonction JetStopServiceInstance

S’applique à : Windows | Windows Server

Fonction JetStopServiceInstance

La fonction JetStopServiceInstance prépare un instance pour l’arrêt.

Windows XP:JetStopServiceInstance est introduit dans Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Paramètres

instance

Le instance en cours d’exécution à utiliser pour l’appel d’API.

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_errInvalidParameter	Le paramètre instance spécifié a une valeur non valide (et non une instance en cours d’exécution). Windows XP : Cette valeur de retour est introduite dans Windows XP.

Si cette fonction réussit, elle se prépare à un arrêt futur. Les étapes prises pour préparer une résiliation 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émoire tampon.

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

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

Notes

Cette fonction réduit le travail que le instance devra 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 a été 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 : JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase et JetResetSessionContext.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista ou Windows XP.
Serveur	Nécessite Windows Server 2008 ou Windows Server 2003.
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