Fonction JetStopBackup

S’applique à : Windows | Windows Server

Fonction JetStopBackup

La fonction JetStopBackup empêche toute activité liée à la sauvegarde en streaming de se poursuivre sur un instance en cours d’exécution spécifique, mettant ainsi fin à la sauvegarde en streaming de manière prévisible.

Windows XP : Cette fonction est introduite dans Windows XP.

JetStopService est l’appel hérité quand un seul instance est autorisé. Dans ce cas, le seul instance actif est celui en cours de préparation pour l’arrêt.

JET_ERR JET_API JetStopBackup(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 quel 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, le instance commencera à échouer toutes les nouvelles API de sauvegarde de streaming.

Si cette fonction échoue, aucune étape de préparation à l’arrêt de la sauvegarde sur le instance ne sera effectuée et aucune modification de l’état instance ne se produira.

Notes

La sauvegarde est généralement déclenchée par un événement en dehors du mécanisme de processus et, à l’aide de cette API, l’application ESENT elle-même fera échouer tous les autres appels aux API de sauvegarde de streaming. La majorité des API de sauvegarde en streaming commencent à échouer avec JET_errBackupAbortByServer. Par conséquent, toute progression de sauvegarde en streaming (comme JetReadFileInstance) retourne une erreur. Les opérations de sauvegarde qui font partie de l’arrêt de la sauvegarde (telles que JetEndExternalBackupInstance) sont toujours autorisées.

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

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService