Fonction JetEndExternalBackup

S’applique à : Windows | Windows Server

Fonction JetEndExternalBackup

La fonction JetEndExternalBackup met fin à une session de sauvegarde externe. Cette fonction est le dernier élément d’API d’une série d’éléments API qui doivent être appelés pour exécuter une sauvegarde en ligne (non basée sur VSS) réussie.

    JET_ERR JET_API JetEndExternalBackup(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_errNotInitialized	L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé.
JET_errClientRequestToStopJetService	L’opération ne peut pas se terminer, car toutes les activités sur le instance associée à la session ont cessé à la suite d’un appel à JetStopService.
JET_errInstanceUnavailable	Windows XP : Cette valeur de retour est introduite dans Windows XP L’opération ne peut pas se terminer, car le instance associé à la session a rencontré une erreur irrécupérable qui exige que l’accès à toutes les données soit révoqué pour protéger l’intégrité de ces données.
JET_errTermInProgress	L’opération ne peut pas se terminer, car le instance associé à la session est en cours d’arrêt.
JET_errRestoreInProgress	L’opération ne peut pas se terminer, car une opération de restauration est en cours sur le instance associé à la session.
JET_errNoBackup	L’opération a échoué, car aucune sauvegarde externe n’est en cours.
JET_errBackupAbortByServer	Windows Server 2003 : Cette valeur de retour est introduite dans Windows Server 2003. L’opération a échoué, car la sauvegarde externe actuelle a été abandonnée par un appel à JetStopBackup.
errBackupAbortByCaller	Windows XP : Cette valeur de retour est introduite dans Windows XP. L’appelant a arrêté une sauvegarde au milieu de la séquence de sauvegarde sans signaler l’intention avec JetStopBackup. Cette erreur est due à un bogue dans le client de sauvegarde dans Windows Server 2003 et versions ultérieures. Sur Windows XP, cette erreur est retournée pour un arrêt intentionnel de la séquence de sauvegarde externe.
JET_errRunningInMultiInstanceMode	L’opération a échoué car une tentative d’utilisation du moteur a été effectuée en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge, alors que plusieurs instances existent déjà.

Si cette fonction réussit, la sauvegarde externe a réussi. La réussite indique que tous les fichiers (par exemple, les bases de données et les journaux) appropriés pour le type de sauvegarde (spécifié dans JetBeginExternalBackup) ont été récupérés à partir du moteur de sauvegarde. Les fichiers sauvegardés peuvent être récupérés avec une récupération matérielle (JetExternalRestore).

Si cette fonction échoue, la sauvegarde externe se termine généralement. L’échec signifie que la sauvegarde n’est pas valide en raison d’une erreur d’utilisation d’un client ou d’une application. Il est important de case activée le code de retour pour cette API afin de vérifier que la séquence de sauvegarde a réussi.

Notes

Si le moteur est configuré pour journaliser les événements, un événement est journalisé pour indiquer la résolution de la sauvegarde externe.

Si la séquence de sauvegarde n’est pas terminée dans l’ordre et avec un appel réussi à JetEndExternalBackup, les sauvegardes incrémentielles suivantes peuvent contenir plus de données que prévu par l’application.

Pour plus d’informations sur la séquence d’API de sauvegarde externe, consultez JetBeginExternalBackup.

Avant Windows Vista, si la troncation du journal n’était pas effectuée, le moteur considérait que la sauvegarde était une sauvegarde de copie. Toutefois, la sauvegarde peut être une sauvegarde normale pour laquelle la troncation n’a pas été effectuée (par exemple, s’il existe des bases de données détachées). L’option JET_bitBackupTruncateDone peut être utilisée pour informer le moteur à ce sujet et autoriser les modifications appropriées de l’en-tête de base de donné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

Paramètres de gestion des erreurs
Erreurs du moteur de stockage extensible
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog