Fonction JetExternalRestore2
S’applique à : Windows | Windows Serveurs
Fonction JetExternalRestore2
La fonction JetExternalRestore2 restaure une sauvegarde externe qui a été effectuée avec les API de sauvegarde externes et fournit des points de contrôle à utiliser pour les opérations de journalisation circulaire. C’est ce que l’on appelle la récupération matérielle, qui est similaire, mais différente de la récupération logicielle, telle qu’elle est exécutée par la fonction JetInit .
Windows xp : JetExternalRestore2 est introduit dans Windows xp.
JET_ERR JET_API JetExternalRestore2(
__in JET_PSTR szCheckpointFilePath,
__in JET_PSTR szLogPath,
__in_opt JET_RSTMAP* rgrstmap,
__in long crstfilemap,
__in JET_PSTR szBackupLogPath,
__in_out JET_LOGINFO* pLogInfo,
__in_opt JET_PSTR szTargetInstanceName,
__in_opt JET_PSTR szTargetInstanceLogPath,
__in_opt JET_PSTR szTargetInstanceCheckpointPath,
__in JET_PFNSTATUS pfn
);
Paramètres
szCheckpointFilePath
Chemin d’accès pour le fichier de point de contrôle à utiliser pendant la récupération si szTargetInstanceCheckpointPath n’est pas spécifié ou si le chemin d’accès a une instance active ou en cours d’exécution.
szLogPath
Chemin d’accès ou répertoire des journaux pour la phase finale (annulation) de la récupération et éventuellement pour les journaux de restauration par progression. Ce chemin d’accès peut être le même que le szBackupLogPath.
rgrstmap
Il s’agit d’un tableau de structures JET_RSTMAP . Il s’agit d’une table de chemins d’accès ou de noms de fichiers anciens et nouveaux. Cela est utilisé, car les bases de données peuvent devoir être récupérées dans un emplacement autre que l’emplacement à partir duquel elles ont été sauvegardées. Dans le cas où plusieurs bases de données sont attachées à un seul jeu de journalisation, le mappage de restauration peut spécifier un sous-ensemble des bases de données à restaurer.
crstfilemap
Nombre d’entrées dans le paramètre de tableau rgrstmap .
szBackupLogPath
Chemin d’accès au répertoire dans lequel les fichiers journaux sont restaurés. Il s’agit des journaux qui ont été lus pendant la séquence de sauvegarde externe. Ce chemin d’accès peut être le même que le szLogPath.
pLogInfo
Le pLogInfo décrit plusieurs aspects des journaux de sauvegarde à récupérer. ce paramètre permet à JetExternalRestore2 de prendre les paramètres genLow et genHigh explicites que JetExternalRestore2 a, ainsi que le nom du journal de base, au lieu d’un nom de base de journal présumé « edb ».
szTargetInstanceName
Ce paramètre est déconseillé et ne peut pas être utilisé dans votre application.
szTargetInstanceLogPath
Le chemin d’accès pour les journaux de restauration par progression si l’emplacement des journaux que vous souhaitez restaurer par progression se trouve dans un ensemble ou une instance de journalisation active. Cela ne doit pas être spécifié si l’instance cible utilise la journalisation circulaire.
szTargetInstanceCheckpointPath
Chemin d’accès du point de contrôle pendant la récupération si aucune instance active n’est en cours d’exécution sur cette cible. Cela ne doit pas être spécifié si l’instance cible utilise la journalisation circulaire.
PFN
Rappel d’État qui indique la progression de la récupération.
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_errBadRestoreTargetInstance |
Le szTargetInstanceLogPath spécifié n’appartient pas à une instance initialisée. cette erreur est renvoyée uniquement dans Windows XP et versions ultérieures. |
JET_errDatabaseCorrupted |
Cela indique que la base de données a été endommagée ou un fichier non reconnu. |
JET_errEndingRestoreLogTooLow |
Cette erreur est retournée si l’une des fichiers journaux dans le szBackupLogPatha une génération de journal supérieure à celle spécifiée dans genHigh ou pLogInfo. ulGenHigh. |
JET_errFileNotFound |
L’opération a échoué, car elle n’a pas pu ouvrir le fichier demandé, car il est introuvable dans le chemin d’accès spécifié. |
JET_errInvalidParameter |
L’un des paramètres fournis contenait une valeur inattendue ou contenait une valeur qui n’a pas de sens lorsqu’elle était associée à la valeur d’un autre paramètre. Cela peut se produire pour JetExternalRestore, et ainsi de suite lorsque le SzTargetCheckpointPath et le szTargetInstanceLogPath ne sont pas tous les deux spécifiés ou non spécifiés. Autrement dit, ils doivent correspondre et être spécifiés ou non spécifiés. |
JET_errInvalidPath |
L’opération a échoué, car le chemin d’accès spécifié est introuvable. |
JET_errOutOfMemory |
L’opération a échoué, car la mémoire peut être allouée pour être terminée. |
JET_errRestoreOfNonBackupDatabase |
Cette erreur est retournée si le fichier de base de données spécifié lors de la restauration n’est pas une base de données qui a été sauvegardée avec une sauvegarde externe. |
JET_errRunningInOneInstanceMode |
Le moteur de base de données ne peut pas exécuter une restauration externe ou une récupération matérielle en mode instance unique. cette erreur est renvoyée uniquement dans Windows XP et versions ultérieures. |
JET_errStartingRestoreLogTooHigh |
Cette erreur est retournée si l’un des fichiers journaux dans szBackupLogPatha une génération de journal ci-dessous, spécifiée par genLow ou pLogInfo. ulGenLow. |
En cas de réussite, toutes les bases de données du rgrstmap sont entièrement récupérées et dans un état propre ou cohérent. À ce stade, la base de données peut être remontée sur une instance existante.
En cas d’échec, le moteur n’a pas pu récupérer la base de données. La base de données est dans un État non valide et, afin de retenter la récupération matérielle, la base de données entière doit être restaurée à nouveau. En règle générale, la source d’une telle situation est l’endommagement du disque ou du journal, ou une autre forme de gestion des journaux ou un ensemble de journaux non continus.
Remarques
Consultez JetExternalRestore.
Configuration requise
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista ou Windows XP. |
Serveur |
requiert Windows server 2008 ou Windows server 2003. |
En-tête |
Déclaré dans esent. h. |
Bibliothèque |
Utilisez ESENT. lib. |
DLL |
Requiert ESENT.dll. |
Unicode |
Implémenté en tant que JetExternalRestore2W (Unicode) et JetExternalRestore2A (ANSI). |
Voir aussi
JET_ERR
JET_LOGINFO
JET_PFNSTATUS
JET_RSTMAP
JetBeginExternalBackup
JetExternalRestore
JetInit