Fonction JetStopBackupInstance

S’applique à : Windows | serveur Windows

Fonction JetStopBackupInstance

La fonction JetStopBackupInstance empêche la poursuite de l’activité liée à la sauvegarde en continu sur une instance en cours d’exécution spécifique, ce qui met fin à la sauvegarde de diffusion en continu de manière prévisible.

Windows XP:JetStopBackupInstance est introduit dans Windows XP.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Paramètres

Exemple

Identifie l’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 extensible Stockage 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 (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, l’instance spécifiée démarre l’échec des nouvelles API de sauvegarde de streaming.

Si cette fonction échoue, aucune procédure de préparation de l’arrêt de sauvegarde sur l’instance n’est effectuée et aucune modification de l’état de l’instance ne se produit.

Remarques

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 effectue d’autres appels aux API de sauvegarde de streaming pour échouer. La majorité des API de sauvegarde de streaming commencent à échouer avec JET_errBackupAbortByServer. Par conséquent, toute progression de sauvegarde de streaming (par exemple JetReadFileInstance) retourne une erreur. Les opérations de sauvegarde qui font partie de l’arrêt de sauvegarde (comme JetEndExternalBackupInstance) sont toujours autorisées.

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
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService