Fonction JetEndExternalBackupInstance

S’applique à : Windows | Windows Server

Fonction JetEndExternalBackupInstance

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

Windows XP : JetEndExternalBackupInstance est introduit dans Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance(
      __in          JET_INSTANCE instance
    );

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

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. Sinon, l’opération échoue avec JET_errRunningInMultiInstanceMode.

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 arrêté 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. Sur Windows XP, cette erreur est retournée pour un 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 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_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 que plusieurs instances existent déjà.
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 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 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
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog