JetStopServiceInstance2 fonction)

S’applique à : Windows | Windows Serveurs

La fonction JetStopServiceInstance2 prépare une instance avant de suspendre et prépare une instance après la reprise. les états d’interruption et de reprise sont les états d’exécution du modèle de cycle de vie des applications du Store Windows.

La fonction JetStopServiceInstance2 a été introduite dans Windows 8.

JET_ERR JET_API JetStopServiceInstance2(
  _In_          JET_INSTANCE       instance
  _In_          const JET_GRBIT    grbit
);

Paramètres

instancié

Instance cible. Le type de données JET_INSTANCE est un descripteur de l’instance de la base de données à utiliser pour un appel à l’API jet. Ce descripteur est obtenu lorsque vous créez une instance de la base de données en appelant les fonctions JetCreateInstance, JetCreateInstance2, JetInitou JetInit2 .

grbit

Groupe de bits qui spécifie une ou plusieurs des valeurs énumérées et définies dans le tableau suivant.

Valeur

Description

JET_bitStopServiceAll

arrête tous les services ESE (Extensible Stockage Engine) pour l’instance spécifiée.

JET_bitStopServiceBackgroundUserTasks

Arrête les tâches de maintenance en arrière-plan du client redémarrables (par exemple, la défragmentation B + Tree).

JET_bitStopServiceQuiesceCaches

Quiesces tous les caches modifiés sur le disque. Cette valeur est asynchrone et peut être annulée.

JET_bitStopServiceResume

Reprend les opérations StopService précédemment émises ; autrement dit, il redémarre le service. Cette valeur peut être combinée avec le paramètre grbits pour reprendre des services spécifiques, ou avec JET_bitStopServiceAll pour reprendre tous les services précédemment arrêtés. Ce bit ne peut être utilisé que pour reprendre StopServiceBackgroundUserTasks et JET_bitStopServiceQuiesceCaches. Si vous avez précédemment appelé avec JET_bitStopServiceAll, une tentative d’utilisation de JET_bitStopServiceResume échouera. Si la deuxième étape de reprise n’est pas appelée, l’application aura une dégradation des performances. Dans ce cas, le point de contrôle est conservé à zéro.

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 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.

Notes

Cette fonction permet à une application JET de déplacer le cache de base de données à un état propre ou presque propre (avec les e/s du système d’exploitation inactives), de sorte que si l’application doit être arrêtée, la récupération est rapide. Cette approche est préférable à l’arrêt de JET en appelant les fonctions JetTerm ou JetDetachDatabase , de sorte que dans le scénario le plus courant, l’application n’est pas suspendue, et par la suite, l’application dispose de l’ensemble du cache et est prête à être utilisée dès que possible.

Si cette fonction est réussie, elle prépare le cache de base de données pour une suspension imminente. Cette fonction met en file d’attente le travail sur un thread de travail en arrière-plan et retourne immédiatement à l’appelant. La fonction doit être appelée en fonction de l’VisibilityNotice de PLM, plutôt que d’appeler à partir du gestionnaire d’événements de suspension de l’application pour s’assurer que JET a le temps de vider les tampons modifiés avant que la gestion PLM interrompe/arrête le processus. En interne, JET déclenche une distribution immédiate de la maintenance des points de contrôle lors de la modification de la configuration (soit la mise à jour des points de contrôle, soit le nouveau bit de suspension des caches). Pour plus d’informations sur les événements VisibilityNotice, consultez classe VisibilityChangedEventArgs.

Cette fonction doit être appelée deux fois. Elle est appelée une fois que l’application a reçu l’avis de suspension du système d’exploitation, mais avant que l’application ne soit interrompue. Ensuite, il est à nouveau appelé après que le système d’exploitation a repris l’application. Par exemple :

En cas d’appel pour suspendre : JET_ERR JET_API JetStopServiceInstance2 (instance, JET_bitStopServiceQuiesceCaches);

En cas de reprise : JET_ERR JET_API JetStopServiceInstance2 (instance, JET_bitStopServiceQuiesceCaches | JET_bitStopServiceResume);

Spécifications

Condition requise Valeur

Client

Requiert Windows 8.

Serveur

Requiert Windows Server 2012.

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