JetStopServiceInstance fonction)
S’applique à : Windows | Windows Serveurs
JetStopServiceInstance fonction)
La fonction JetStopServiceInstance prépare une instance pour l’arrêt.
**Windows xp :**JetStopServiceInstance est introduit dans Windows xp.
JET_ERR JET_API JetStopServiceInstance(
__in JET_INSTANCE instance
);
Paramètres
instancié
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 d’instance spécifié a une valeur non valide (pas une instance en cours d’exécution). 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 permet de réduire le travail que l’instance doit effectuer une fois terminé, 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 ou Windows XP. |
Serveur |
requiert Windows server 2008 ou Windows server 2003. |
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