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)