Partager via


Classe IVssBackupComponents (vsbackup.h)

L’interface IVssBackupComponents est utilisée par un demandeur pour interroger les rédacteurs sur les status de fichiers et pour exécuter des opérations de sauvegarde/restauration.

Les applications obtiennent une instance de l’interface IVssBackupComponents en appelant CreateVssBackupComponents.

Un objet IVssBackupComponents ne peut être utilisé que pour une seule opération de sauvegarde, de restauration ou de requête .

Une fois l’opération de sauvegarde, de restauration ou de requête terminée ou explicitement terminée, un demandeur doit libérer l’objet IVssBackupComponents en appelant IVssBackupComponents::Release. Un objet IVssBackupComponents ne doit pas être réutilisé. Par exemple, vous ne pouvez pas effectuer une opération de sauvegarde ou de restauration avec le même objet IVssBackupComponents que vous avez déjà utilisé pour une opération de requête .

Héritage

L’interface IVssBackupComponents hérite de l’interface IUnknown. IVssBackupComponents a également les types de membres suivants :

Méthodes

La classe IVssBackupComponents possède ces méthodes.

 
IVssBackupComponents::AbortBackup

La méthode AbortBackup avertit VSS qu’une opération de sauvegarde a été arrêtée.
IVssBackupComponents::AddAlternativeLocationMapping

La méthode AddAlternativeLocationMapping est utilisée par un demandeur pour indiquer qu’un autre mappage d’emplacement a été utilisé pour restaurer tous les membres d’un jeu de fichiers dans un composant donné.
IVssBackupComponents::AddComponent

Utilisé pour ajouter explicitement au jeu de sauvegarde.
IVssBackupComponents::AddNewTarget

La méthode AddNewTarget est utilisée par un demandeur lors d’une opération de restauration pour indiquer que l’application de sauvegarde prévoit de restaurer des fichiers à un nouvel emplacement.
IVssBackupComponents::AddRestoreSubcomponent

Indique qu’un sous-composant membre d’un jeu de composants, qui avait été marqué comme non sélectionnable pour la sauvegarde, mais qui est marqué comme pouvant être restauré, doit être restauré.
IVssBackupComponents::AddToSnapshotSet

La méthode AddToSnapshotSet ajoute un volume d’origine ou un partage de fichiers distant d’origine au jeu de cliché instantané.
IVssBackupComponents::BackupComplete

La méthode BackupComplete permet à VSS de générer un événement BackupComplete, qui signale aux enregistreurs que le processus de sauvegarde est terminé.
IVssBackupComponents::BreakSnapshotSet

La méthode BreakSnapshotSet fait que l’existence d’un jeu de clichés instantanés est « oubliée » par VSS.
IVssBackupComponents::D eleteSnapshots

La méthode DeleteSnapshots supprime un ou plusieurs clichés instantanés ou un jeu de clichés instantanés.
IVssBackupComponents::D isableWriterClasses

La méthode DisableWriterClasses empêche une classe spécifique d’enregistreurs de recevoir des événements.
IVssBackupComponents::D isableWriterInstances

La méthode DisableWriterInstances désactive un enregistreur spécifié instance ou instances.
IVssBackupComponents::D oSnapshotSet

Valide tous les clichés instantanés de ce jeu simultanément.
IVssBackupComponents::EnableWriterClasses

La méthode EnableWriterClasses permet aux rédacteurs spécifiés de recevoir tous les événements.
IVssBackupComponents::ExposeSnapshot

La méthode ExposeSnapshot expose un cliché instantané sous forme de lettre de lecteur, de dossier monté ou de partage de fichiers.
IVssBackupComponents::FreeWriterMetadata

La méthode FreeWriterMetadata libère les ressources système allouées lorsque IVssBackupComponents::GatherWriterMetadata a été appelé.
IVssBackupComponents::FreeWriterStatus

La méthode FreeWriterStatus libère les ressources système allouées lors de l’appel à IVssBackupComponents::GatherWriterStatus.
IVssBackupComponents::GatherWriterMetadata

La méthode GatherWriterMetadata invite chaque rédacteur à envoyer les métadonnées qu’il a collectées. La méthode génère un événement Identifier pour communiquer avec les rédacteurs.
IVssBackupComponents::GatherWriterStatus

La méthode GatherWriterStatus invite chaque rédacteur à envoyer un message status.
IVssBackupComponents::GetSnapshotProperties

La méthode GetSnapshotProperties obtient les propriétés du cliché instantané spécifié.
IVssBackupComponents::GetWriterComponents

La méthode GetWriterComponents est utilisée pour retourner des informations sur les composants d’un enregistreur donné qui ont été stockés dans le document composants de sauvegarde d’un demandeur.
IVssBackupComponents::GetWriterComponentsCount

La méthode GetWriterComponentsCount retourne le nombre d’enregistreurs dont les composants ont été ajoutés au document de composants de sauvegarde d’un demandeur.
IVssBackupComponents::GetWriterMetadata

La méthode GetWriterMetadata retourne les métadonnées d’un enregistreur spécifique s’exécutant sur le système.
IVssBackupComponents::GetWriterMetadataCount

La méthode GetWriterMetadataCount retourne le nombre d’enregistreurs avec des métadonnées.
IVssBackupComponents::GetWriterStatus

La méthode GetWriterStatus retourne le status de l’enregistreur spécifié.
IVssBackupComponents::GetWriterStatusCount

La méthode GetWriterStatusCount retourne le nombre d’enregistreurs avec status.
IVssBackupComponents::ImportSnapshots

Importe les clichés instantanés transportés à partir d’un autre ordinateur.
IVssBackupComponents::InitializeForBackup

La méthode InitializeForBackup initialise les métadonnées des composants de sauvegarde en préparation de la sauvegarde.
IVssBackupComponents::InitializeForRestore

La méthode InitializeForRestore initialise l’interface IVssBackupComponents en préparation d’une opération de restauration.
IVssBackupComponents::IsVolumeSupported

La méthode IsVolumeSupported détermine si le fournisseur spécifié prend en charge les clichés instantanés sur le volume ou le partage de fichiers distant spécifié.
IVssBackupComponents::P ostRestore

La méthode PostRestore entraîne la génération d’un événement PostRestore par VSS, signalant aux enregistreurs que l’opération de restauration en cours est terminée.
IVssBackupComponents::P repareForBackup

La méthode PrepareForBackup entraîne la génération par VSS d’un événement PrepareForBackup, signalant aux enregistreurs de se préparer à une opération de sauvegarde à venir. Cela rend le document des composants de sauvegarde d’un demandeur disponible pour les rédacteurs.
IVssBackupComponents::P reRestore

La méthode PreRestore va amener VSS à générer un événement PreRestore, signalant aux enregistreurs de se préparer pour une opération de restauration à venir.
IVssBackupComponents::Query

La méthode Query interroge les fournisseurs sur le système et/ou les clichés instantanés terminés dans le système qui résident dans le contexte actuel. La méthode peut être appelée uniquement pendant les opérations de sauvegarde.
IVssBackupComponents::QueryRevertStatus

Retourne un pointeur d’interface IVssAsync qui peut être utilisé pour déterminer la status de l’opération de restauration. (IVssBackupComponents.QueryRevertStatus)
IVssBackupComponents::RevertToSnapshot

Rétablit un volume à un cliché instantané précédent. (IVssBackupComponents.RevertToSnapshot)
IVssBackupComponents::SaveAsXML

La méthode SaveAsXML enregistre le document de composants de sauvegarde contenant les informations d’état d’un demandeur dans une chaîne spécifiée. Ce document XML, qui contient le document Composants de sauvegarde, doit toujours être enregistré de manière sécurisée dans le cadre d’une opération de sauvegarde.
IVssBackupComponents::SetAdditionalRestores

La méthode SetAdditionalRestores est utilisée par un demandeur lors des opérations de restauration incrémentielle ou différentielle pour indiquer aux enregistreurs qu’un composant donné aura besoin d’opérations de restauration supplémentaires pour le récupérer complètement.
IVssBackupComponents::SetBackupOptions

La méthode SetBackupOptions définit une chaîne de paramètres de sauvegarde privés ou dépendants de l’enregistreur pour un composant.
IVssBackupComponents::SetBackupState

La méthode SetBackupState définit une configuration globale pour une opération de sauvegarde.
IVssBackupComponents::SetBackupSucceededed

La méthode SetBackupSucceededed indique si la sauvegarde du composant spécifié d’un enregistreur spécifique a réussi.
IVssBackupComponents::SetContext

La méthode SetContext définit le contexte pour les opérations ultérieures liées au cliché instantané.
IVssBackupComponents::SetFileRestoreStatus

La méthode SetFileRestoreStatus indique si certains fichiers, tous ou aucun fichier ont été correctement restaurés.
IVssBackupComponents::SetPreviousBackupStamp

La méthode SetPreviousBackupStamp définit l’empreinte de sauvegarde d’une opération de sauvegarde antérieure, sur laquelle une opération de sauvegarde différentielle ou incrémentielle sera basée.
IVssBackupComponents::SetRangesFilePath

La méthode SetRangesFilePath est utilisée lorsqu’une opération de fichier partielle nécessite un fichier de plages et que ce fichier a été restauré à un emplacement autre que celui d’origine.
IVssBackupComponents::SetRestoreOptions

La méthode SetRestoreOptions définit une chaîne de paramètres de restauration privés ou dépendants de l’enregistreur pour un composant d’enregistreur.
IVssBackupComponents::SetRestoreState

La méthode SetRestoreState définit une configuration globale pour une opération de restauration.
IVssBackupComponents::SetSelectedForRestore

La méthode SetSelectedForRestore indique si le composant sélectionnable spécifié est sélectionné pour la restauration.
IVssBackupComponents::StartSnapshotSet

La méthode StartSnapshotSet crée un jeu de cliché instantané vide.

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 vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)