Méthode IVssComponent::GetAdditionalRestores (vswriter.h)

  • Article

La méthode GetAdditionalRestores est utilisée par un enregistreur pendant les opérations de restauration incrémentielle ou différentielle pour déterminer si un composant donné nécessite des opérations de restauration supplémentaires pour le récupérer complètement.

Un writer ou un demandeur peut appeler cette méthode.

Syntaxe

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Paramètres

[out] pbAdditionalRestores

Adresse d’une variable allouée à l’appelant qui reçoit true si des restaurations supplémentaires se produisent pour le composant actuel, ou false dans le cas contraire.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur Signification
S_OK
 La valeur de l’attribut a été retournée.
S_FALSE
 L’attribut spécifié n’a pas de valeur.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT
 Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

La valeur retournée par GetAdditionalRestores est false, sauf si, lors d’une opération de restauration, un demandeur appelle IVssBackupComponents::SetAdditionalRestores.

GetAdditionalRestores doit être utilisé pour case activée s’il est nécessaire d’utiliser plusieurs ensembles de sauvegarde pour restaurer complètement un composant. Un composant peut d’abord être récupéré en restaurant des données à partir d’une sauvegarde complète, puis en mettant à jour ces données à partir d’une ou plusieurs sauvegardes incrémentielles ou différentielles ultérieures.

La méthode GetAdditionalRestores est généralement utilisée par les rédacteurs qui prennent en charge un mécanisme de récupération explicite dans le cadre de leur gestionnaire d’événements PostRestore (CVssWriter::OnPostRestore), pour instance, le Exchange Server et les applications de base de données telles que SQL Server. Pour ces applications, il n’est souvent pas possible d’effectuer des restaurations différentielles, incrémentielles ou de journaux supplémentaires après une telle récupération.

Par conséquent, si GetAdditionalRestores retourne true pour un composant, un tel enregistreur ne doit pas exécuter son mécanisme de récupération explicite et doit s’attendre à ce que des restaurations différentielles, incrémentielles ou de journaux supplémentaires soient effectuées.

Lorsque SetAdditionalRestores retourne false, une fois la restauration terminée, lors de la gestion de l’événement PostRestore , l’enregistreur peut terminer son opération de récupération et être remis en ligne.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque VssApi.lib

Voir aussi

IVssComponent