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

La méthode AddDirectedTarget permet à un enregistreur d’indiquer au moment de la restauration que lorsqu’un fichier doit être restauré, il (le fichier source) doit être réappdé. Le fichier peut être restauré vers un nouvel emplacement de restauration et/ou des plages de ses données restaurées à différents décalages dans l’emplacement de restauration.

Cette méthode peut être appelée par un enregistreur uniquement pendant une opération de restauration.

Cette méthode ne peut pas être appelée lors de la gestion d’un événement BackupComplete (CVssWriter ::OnBackupComplete) ou BackupShutdown (CVssWriter ::OnBackupShutdown).

Syntaxe

HRESULT AddDirectedTarget(
  [in] LPCWSTR wszSourcePath,
  [in] LPCWSTR wszSourceFilename,
  [in] LPCWSTR wszSourceRangeList,
  [in] LPCWSTR wszDestinationPath,
  [in] LPCWSTR wszDestinationFilename,
  [in] LPCWSTR wszDestinationRangeList
);

Paramètres

[in] wszSourcePath

Chaîne de caractères larges terminées par null contenant le chemin d’accès au répertoire au moment de la restauration contenant le fichier à restaurer (le fichier source). Ce chemin doit correspondre ou se trouver sous le chemin d’accès d’un jeu de fichiers déjà dans le composant (ou l’un de ses sous-composants si le composant définit un jeu de composants).

[in] wszSourceFilename

Chaîne de caractères larges terminée par null contenant le nom du fichier (au moment de la sauvegarde) qui sera remappé au moment de la restauration (le fichier source). Le nom du fichier (wszSourceFilename) ne peut pas contenir de caractères génériques (* ou ?) et doit être cohérent avec la spécification de fichier d’un jeu de fichiers contenant le chemin d’accès source (wszSourcePath).

[in] wszSourceRangeList

Chaîne de caractères larges terminée par null contenant une liste séparée par des virgules de décalages et de longueurs de fichier indiquant la plage de prise en charge du fichier source (les sections du fichier à restaurer).

Le nombre et la longueur des plages de prise en charge des fichiers sources doivent correspondre au nombre et à la taille des plages de prise en charge des fichiers de destination.

[in] wszDestinationPath

Chaîne de caractères larges terminées par null contenant le chemin d’accès auquel les données de fichier source seront réappées au moment de la restauration.

[in] wszDestinationFilename

Chaîne de caractères larges terminées par null contenant le nom du fichier dans lequel les données du fichier source seront réapppliquées au moment de la restauration. Le nom du fichier (wszDestinationFilename) ne peut pas contenir de caractères génériques (* ou ?).

[in] wszDestinationRangeList

Chaîne de caractères larges terminée par null contenant une liste séparée par des virgules de décalages et de longueurs de fichier indiquant la plage de prise en charge du fichier de destination (emplacements dans lesquels les sections du fichier source doivent être restaurées).

Le nombre et la longueur des plages de prise en charge des fichiers de destination doivent correspondre au nombre et à la taille des plages de prise en charge des fichiers sources.

Valeur retournée

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

Valeur	Signification
S_OK	Définissez correctement l’élément.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE	Cette méthode n’a pas été appelée par un enregistreur ou, si elle est appelée par un enregistreur, elle n’a pas été appelée lors d’une opération de restauration ou a été appelée lors de la gestion d’un événement BackupComplete ou BackupShutdown .

Remarques

Seul un enregistreur peut appeler AddDirectedTarget, et uniquement pendant les opérations de restauration.

Un demandeur utilise les informations cibles dirigées stockées dans le document composants de sauvegarde uniquement si la cible de restauration est VSS_RT_DIRECTED.

La méthode AddDirectedTarget peut être appliquée à n’importe quel fichier géré dans le composant actuel ou, si le composant définit un ensemble de composants, dans l’un de ses sous-composants non sélectionnables.

Les spécifications de fichier source et de destination peuvent pointer vers le même fichier. Cela permet de réappliquer un fichier en lui-même au moment de la restauration.

La syntaxe de la liste de plages (wszSourceRanges et wszDestinationRanges) est celle d’une liste séparée par des virgules du format offset1 :length1, offset2 :length2, où chaque décalage et longueur est un entier 64 bits spécifiant respectivement un décalage d’octets et une longueur en octets. Le décalage et la longueur peuvent être exprimés sous forme de valeurs hexadécimales ou décimales.

Le nombre d’entrées et leurs tailles doivent correspondre dans les arguments de plage source et de destination.

AddDirectedTarget peut utiliser comme fichier source n’importe quel fichier déjà géré par le composant ou l’un de ses sous-composants si le composant définit un jeu de composants.

Des fichiers partiels peuvent être ajoutés en tant que cibles dirigées, si les plages de fichiers partielles à sauvegarder correspondent aux plages de sources cibles dirigées (voir IVssComponent ::AddPartialFile). Cela vous permettra de remappper des fichiers partiels au moment de la restauration.

Dans ce cas, le demandeur récupère les informations cibles dirigées en appelant la méthode IVssComponent ::GetDirectedTarget et l’utilise pour implémenter le remapping des données sauvegardées pendant la restauration.

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)
Bibliothèque	VssApi.lib

Voir aussi

IVssComponent

IVssComponent ::GetDirectedTarget

IVssComponent ::GetDirectedTargetCount