Fonction JetEndExternalBackupInstance2

S’applique à : Windows | Windows Server

Fonction JetEndExternalBackupInstance2

La fonction JetEndExternalBackupInstance2 met fin à une session de sauvegarde externe. Cette API est la dernière API d’une série d’API qui doivent être appelées pour exécuter une sauvegarde en ligne (non basée sur VSS) réussie.

Windows XP : JetEndExternalBackupInstance2 est introduit dans Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Paramètres

instance

Instance à utiliser pour cet appel.

Windows 2000 : Pour Windows 2000, la variante d’API qui accepte ce paramètre n’est pas disponible, car une seule instance est prise en charge. L’utilisation de cette instance globale est implicite dans le cas présent.

Windows XP : Pour Windows XP et les versions ultérieures, la variante d’API qui n’accepte pas ce paramètre ne peut être appelée que lorsque le moteur est en mode hérité (mode de compatibilité Windows 2000) où une seule instance est prise en charge. Dans le cas contraire, l’opération échoue avec JET_errRunningInMultiInstanceMode.

grbit

Groupe de bits qui spécifie zéro ou plusieurs des options suivantes.

Valeur	Signification
JET_bitBackupEndAbort 0x0002	L’application cliente abandonne la sauvegarde.
JET_bitBackupEndNormal 0x0001	L’application cliente a terminé complètement la sauvegarde et se termine normalement.
JET_bitBackupTruncateDone 0x0100	Windows Vista : JET_bitBackupTruncateDone est introduit dans Windows Vista. Le moteur peut marquer les en-têtes de base de données comme appropriés (par exemple, une sauvegarde complète terminée), même si l’appel à tronquer n’a pas été terminé.

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_errBackupAbortByCaller	Windows XP : Cette valeur de retour est introduite dans Windows XP. L’appelant a mis fin à une sauvegarde au milieu de la séquence de sauvegarde sans signaler l’intention avec JetStopBackup. Cette erreur est le résultat d’un bogue dans le client de sauvegarde dans Windows Server 2003 et versions ultérieures. Dans Windows XP, cette erreur est retournée pour une arrêt intentionnel de la séquence de sauvegarde externe.
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.
JET_errClientRequestToStopJetService	L’opération ne peut pas se terminer, car toute l’activité sur le instance associée à la session a 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_errNoBackup	L’opération a échoué, car aucune sauvegarde externe n’est en cours.
JET_errNotInitialized	L’opération ne peut pas se terminer, car le instance associé à la session n’a pas encore été initialisé.
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_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 qu’il existe déjà plusieurs instances.
JET_errTermInProgress	L’opération ne peut pas se terminer, car le instance associé à la session est en cours d’arrêt.

Si la 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 de cette API pour 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 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

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