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
- Mappages d’emplacements alternatifs
- Fichiers partiels
- Cible dirigée
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) |