Fonction JetBeginExternalBackupInstance

S’applique à : Windows | Windows Server

Fonction JetBeginExternalBackupInstance

La fonction JetBeginExternalBackupInstance lance une sauvegarde externe pendant que le moteur et la base de données sont en ligne et actifs.

Windows XP : JetBeginExternalBackupInstance est introduit dans Windows XP.

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

Paramètres

instance

Base de données instance à utiliser pour cet appel.

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.

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 spécifiant zéro ou plusieurs des options suivantes.

Valeur	Signification
JET_bitBackupAtomic	Cet indicateur est déconseillé. L’utilisation de ce bit entraîne le retour de JET_errInvalidgrbit.
JET_bitBackupIncremental	Crée une sauvegarde incrémentielle par opposition à une sauvegarde complète. Cela signifie que seuls les fichiers journaux depuis la dernière sauvegarde complète ou incrémentielle seront sauvegardés.
JET_bitBackupSnapshot	Réservé pour un usage futur. Défini pour Windows XP.

Valeur renvoyée

Le système peut générer des codes de réussite ou d’échec à la suite d’un appel à cette fonction. Pour obtenir la liste complète des erreurs pour cette API, consultez Codes d’erreur du moteur de stockage extensible.

Consultez JetBeginExternalBackup.

Notes

JetBeginExternalBackupInstance est la première fonction d’une série de fonctions qui doivent être appelées pour exécuter une sauvegarde en ligne (non basée sur VSS) réussie. Voir aussi JetBeginExternalBackup et JetStopBackupInstance.

Une sauvegarde externe peut être utilisée pour implémenter des sauvegardes complètes, incrémentielles ou différentielles.

La sauvegarde sera approximative, car la sauvegarde sera cohérente à un seul point dans le temps dans l’historique des transactions, mais le contrôle du point exact dans le temps n’est pas possible pour le moment.

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

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog