Partager via


Classe IVssComponent (vswriter.h)

L’interface IVssComponent est une interface C++ (et non COM) contenant des méthodes permettant d’examiner et de modifier des informations sur les composants contenus dans le document des composants de sauvegarde d’un demandeur.

Les objets IVssComponent peuvent être obtenus uniquement pour les composants qui ont été explicitement ajoutés au document composants de sauvegarde lors d’une opération de sauvegarde par la méthode IVssBackupComponents ::AddComponent .

Les informations sur les composants explicitement ajoutés lors d’une opération de restauration à l’aide de IVssBackupComponents ::AddRestoreSubcomponent ne sont pas disponibles via l’interface IVssComponent .

Voici quelques informations communes aux composants et aux sous-composants implicitement sélectionnés disponibles via les objets IVssComponent :

  • Horodatage de sauvegarde
  • Messages d’échec avant/après restauration
  • Restaurer les métadonnées
  • Cible de restauration
Certaines informations de l’objet IVssComponent sont par fichier et peuvent faire référence à des fichiers gérés par des composants explicitement sélectionnés ou par des sous-composants implicitement sélectionnés :
  • Mappages d’emplacements alternatifs
  • Fichiers partiels
  • Cible dirigée
D’autres informations ne sont pas incluses dans le document Composants de sauvegarde et peuvent être déduites à l’aide de l’objet IVssComponent conjointement avec les documents de métadonnées writer appropriés en fonction de la hiérarchie des composants d’un enregistreur exprimée dans les chemins logiques (voir Utilisation de la sélectabilité et des chemins logiques).

L’interface peut être utilisée par un writer ou un demandeur, bien que certaines méthodes soient prises en charge uniquement pour les enregistreurs. De cette façon, un writer peut demander des modifications dans une opération de sauvegarde ou de restauration, comme l’ajout d’une nouvelle cible, ou découvrir les actions du demandeur, telles que l’utilisation d’un autre emplacement.

Les méthodes suivantes retournent une interface IVssComponent :

Héritage

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

Méthodes

La classe IVssComponent a ces méthodes.

 
IVssComponent ::AddDifferencedFilesByLastModifyLSN

Non pris en charge. (IVssComponent.AddDifferencedFilesByLastModifyLSN)
IVssComponent ::AddDifferencedFilesByLastModifyTime

Utilisé par un enregistreur pour indiquer qu’un jeu de fichiers (un ou plusieurs fichiers spécifiés) doit être évalué par rapport à un horodatage de dernière modification pour l’inclusion dans une sauvegarde incrémentielle ou différentielle horodatée à l’aide de fichiers entiers.
IVssComponent ::AddDirectedTarget

La méthode AddDirectedTarget permet à un writer d’indiquer au moment de la restauration que lorsqu’un fichier doit être restauré, il (le fichier source) doit être remappé.
IVssComponent ::AddPartialFile

La méthode AddPartialFile indique que seules des parties d’un fichier donné doivent être sauvegardées et de quelles parties il s’agit.
IVssComponent ::GetAdditionalRestores

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.
IVssComponent ::GetAlternateLocationMapping

GetAlternateLocationMapping est utilisé pour retourner l’autre emplacement d’un jeu de fichiers pour la restauration de fichiers. Cette méthode peut être appelée par un writer ou un demandeur.
IVssComponent ::GetAlternateLocationMappingCount

La méthode GetAlternateLocationMappingCount retourne le nombre de mappages d’emplacements alternatifs utilisés par un demandeur dans la restauration des données. Un writer ou un demandeur peut appeler cette méthode.
IVssComponent ::GetBackupMetadata

La méthode GetBackupMetadata récupère les métadonnées de sauvegarde privées spécifiques à l’enregistreur qui peuvent avoir été définies pendant un événement PrepareForBackup par CVssWriter ::OnPrepareBackup à l’aide de IVssComponent ::SetBackupMetadata.
IVssComponent ::GetBackupOptions

La méthode GetBackupOptions renvoie les options de sauvegarde spécifiées au writer qui gère le composant ou le composant actuellement sélectionné défini par un demandeur à l’aide de IVssBackupComponents ::SetBackupOptions.
IVssComponent ::GetBackupStamp

La méthode GetBackupStamp retourne la chaîne d’empreinte de sauvegarde stockée par un writer pour un composant donné.
IVssComponent ::GetBackupSucceeded

La méthode GetBackupSucceeded retourne la status d’une tentative complète de sauvegarde de tous les fichiers d’un composant ou d’un jeu de composants sélectionnés en tant qu’énumération VSS_FILE_RESTORE_STATUS.
IVssComponent ::GetComponentName

La méthode GetComponentName retourne le nom logique de ce composant.
IVssComponent ::GetComponentType

La méthode GetComponentType retourne le type de ce composant en termes d’énumération VSS_COMPONENT_TYPE.
IVssComponent ::GetDifferencedFile

La méthode GetDifferencedFile retourne des informations sur un jeu de fichiers (un ou plusieurs fichiers spécifiés) à participer à une sauvegarde ou à une restauration incrémentielle ou différentielle en tant que fichier différent, c’est-à-dire que la sauvegarde et les restaurations associées doivent être implémentées comme si des fichiers entiers étaient copiés vers et à partir du support de sauvegarde (au lieu d’utiliser des fichiers partiels).
IVssComponent ::GetDifferencedFilesCount

Retourne le nombre de spécifications de fichiers dans ce composant (et dans tous les sous-composants du jeu de composants qu’il définit) marquées par un enregistreur prenant en charge une sauvegarde ou une restauration incrémentielle en tant que fichiers différentiels.
IVssComponent ::GetDirectedTarget

La méthode GetDirectedTarget retourne des informations stockées par un enregistreur, au moment de la sauvegarde, dans le document composants de sauvegarde pour indiquer que lorsqu’un fichier doit être restauré, il (le fichier source) doit être remappé.
IVssComponent ::GetDirectedTargetCount

La méthode GetDirectedTargetCount retourne le nombre de spécifications de cible dirigées associées au composant actuel. Un writer ou un demandeur peut appeler cette méthode.
IVssComponent ::GetFileRestoreStatus

La méthode GetFileRestoreStatus retourne la status d’une tentative de restauration de tous les fichiers d’un composant ou d’un jeu de composants sélectionnés en tant qu’énumération VSS_FILE_RESTORE_STATUS.
IVssComponent ::GetLogicalPath

La méthode GetLogicalPath retourne le chemin logique de ce composant.
IVssComponent ::GetNewTarget

La méthode GetNewTarget retourne les nouveaux emplacements de restauration de fichiers pour le composant ou l’ensemble de composants sélectionné.
IVssComponent ::GetNewTargetCount

La méthode GetNewTargetCount retourne le nombre de nouveaux emplacements de restauration cibles associés à un composant donné.
IVssComponent ::GetPartialFile

La méthode GetPartialFile retourne des informations sur un fichier partiel associé à ce composant.
IVssComponent ::GetPartialFileCount

La méthode GetPartialFileCount retourne le nombre de fichiers partiels associés à un composant.
IVssComponent ::GetPostRestoreFailureMsg

La méthode GetPostRestoreFailureMsg retourne le message d’échec généré par un writer lors de la gestion de l’événement PostRestore, si IVssComponent ::SetPostRestoreFailureMsg en définit un.
IVssComponent ::GetPreRestoreFailureMsg

La méthode GetPreRestoreFailureMsg récupère le message d’erreur généré par un writer lors de la gestion de l’événement PreRestore, si IVssComponent ::SetPreRestoreFailureMsg en définit un.
IVssComponent ::GetPreviousBackupStamp

La méthode GetPreviousBackupStamp retourne un tampon de sauvegarde précédent chargé par un demandeur dans le document Composants de sauvegarde. La valeur est utilisée par un enregistreur pour décider si les fichiers doivent participer à une opération de sauvegarde différentielle ou incrémentielle.
IVssComponent ::GetRestoreMetadata

La méthode GetRestoreMetadata récupère les métadonnées de restauration privées spécifiques à l’enregistreur qui peuvent avoir été définies pendant un événement PreRestore par CVssWriter ::OnPreRestore à l’aide de IVssComponent ::SetRestoreMetadata.
IVssComponent ::GetRestoreOptions

La méthode GetRestoreOptions obtient les options de restauration spécifiées sur l’enregistreur actuel par un demandeur à l’aide de IVssBackupComponents ::SetRestoreOptions.
IVssComponent ::GetRestoreSubcomponent

La méthode GetRestoreSubcomponent retourne le sous-composant spécifié associé à un composant donné.
IVssComponent ::GetRestoreSubcomponentCount

La méthode GetRestoreSubcomponentCount retourne le nombre de sous-composants associés à un composant.
IVssComponent ::GetRestoreTarget

La méthode GetRestoreTarget retourne la cible de restauration (en termes d’énumération VSS_RESTORE_TARGET) pour le composant actuel.
IVssComponent ::IsSelectedForRestore

La méthode IsSelectedForRestore détermine si le composant actuel a été sélectionné pour être restauré.
IVssComponent ::SetBackupMetadata

La méthode SetBackupMetadata définit les métadonnées de sauvegarde avec le composant .
IVssComponent ::SetBackupStamp

La méthode SetBackupStamp définit une chaîne contenant des informations indiquant quand une sauvegarde a eu lieu.
IVssComponent ::SetPostRestoreFailureMsg

La méthode SetPostRestoreFailureMsg est utilisée pour créer un message décrivant un échec dans le traitement d’un événement PostRestore.
IVssComponent ::SetPreRestoreFailureMsg

La méthode SetPreRestoreFailureMsg est utilisée pour créer un message décrivant un échec dans le traitement d’un événement PreRestore.
IVssComponent ::SetRestoreMetadata

La méthode SetRestoreMetadata définit des métadonnées spécifiques à l’enregistreur pour le composant actuel.
IVssComponent ::SetRestoreTarget

La méthode SetRestoreTarget définit la cible de restauration (en termes d’énumération VSS_RESTORE_TARGET) pour le composant actuel.

Configuration requise

Condition requise Valeur
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)