Metodo IVssComponent::AddDirectedTarget (vswriter.h)
Il metodo AddDirectedTarget consente a un writer di indicare al momento del ripristino che quando un file deve essere ripristinato, il file di origine deve essere ripristinato. Il file può essere ripristinato in una nuova posizione di ripristino e/o in intervalli dei relativi dati ripristinati in offset diversi all'interno del percorso di ripristino.
Questo metodo può essere chiamato da un writer solo durante un'operazione di ripristino.
Questo metodo non può essere chiamato durante la gestione di un evento BackupComplete (CVssWriter::OnBackupComplete) o BackupShutdown (CVssWriter::OnBackupShutdown).
Sintassi
HRESULT AddDirectedTarget(
[in] LPCWSTR wszSourcePath,
[in] LPCWSTR wszSourceFilename,
[in] LPCWSTR wszSourceRangeList,
[in] LPCWSTR wszDestinationPath,
[in] LPCWSTR wszDestinationFilename,
[in] LPCWSTR wszDestinationRangeList
);
Parametri
[in] wszSourcePath
Stringa di caratteri wide con terminazione null contenente il percorso della directory in fase di ripristino contenente il file da ripristinare (file di origine). Questo percorso deve corrispondere o essere sotto il percorso di un set di file già nel componente (o uno dei relativi sottocomponenti se il componente definisce un set di componenti).
[in] wszSourceFilename
Stringa di caratteri wide con terminazione null contenente il nome del file (in fase di backup) che verrà ripristinata al momento del ripristino (file di origine). Il nome del file (wszSourceFilename) non può contenere caratteri jolly (* o ?) e deve essere coerente con la specifica del file di un set di file contenente il percorso di origine (wszSourcePath).
[in] wszSourceRangeList
Stringa di caratteri wide con terminazione null contenente un elenco delimitato da virgole di offset e lunghezze dei file che indicano l'intervallo di supporto dei file di origine (le sezioni del file da ripristinare).
Il numero e la lunghezza degli intervalli di supporto file di origine devono corrispondere al numero e alle dimensioni degli intervalli di supporto dei file di destinazione.
[in] wszDestinationPath
Stringa di caratteri wide con terminazione null contenente il percorso a cui i dati del file di origine verranno ripristinati in fase di ripristino.
[in] wszDestinationFilename
Stringa di caratteri wide con terminazione null contenente il nome del file in cui i dati del file di origine verranno ripristinati in fase di ripristino. Il nome del file (wszDestinationFilename) non può contenere caratteri jolly (* o ?).
[in] wszDestinationRangeList
Stringa di caratteri wide con terminazione null contenente un elenco delimitato da virgole di offset e lunghezze dei file che indicano l'intervallo di supporto dei file di destinazione (percorsi a cui devono essere ripristinate le sezioni del file di origine).
Il numero e la lunghezza degli intervalli di supporto file di destinazione devono corrispondere al numero e alle dimensioni degli intervalli di supporto file di origine.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Impostare correttamente l'elemento. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Questo metodo non è stato chiamato da un writer o, se chiamato da un writer, non è stato chiamato durante un'operazione di ripristino o è stato chiamato durante la gestione di un evento BackupComplete o BackupShutdown . |
Commenti
Solo un writer può chiamare AddDirectedTarget e solo durante le operazioni di ripristino.
Un richiedente userà le informazioni di destinazione dirette archiviate nel documento Componenti di backup solo se la destinazione di ripristino è VSS_RT_DIRECTED.
Il metodo AddDirectedTarget può essere applicato a qualsiasi file gestito nel componente corrente o, se il componente definisce un set di componenti, in uno dei relativi sottocomponenti non selezionabili.
Le specifiche del file di origine e di destinazione possono puntare allo stesso file. In questo modo è possibile eseguire il mapping di un file in se stesso in fase di ripristino.
La sintassi dell'elenco di intervalli (wszSourceRanges ewszDestinationRanges) è quella di un elenco delimitato da virgole dell'offset1:length1, offset2:length2, in cui ogni offset e lunghezza è un intero a 64 bit che specifica un offset di byte e una lunghezza rispettivamente in byte. L'offset e la lunghezza possono essere espressi come valori esadecimali o decimali.
Il numero di voci e le relative dimensioni deve corrispondere agli argomenti dell'intervallo di origine e di destinazione.
AddDirectedTarget può usare come file di origine qualsiasi file già gestito dal componente o uno dei relativi sottocomponenti se il componente definisce un set di componenti.
I file parziali possono essere aggiunti come destinazioni indirizzate, se gli intervalli di file parziali devono essere sottoposti a backup corrispondenti agli intervalli di origine di destinazione diretta (vedere IVssComponent::AddPartialFile). In questo modo è possibile eseguire il mapping dei file parziali in fase di ripristino.
In questo caso, il richiedente recupera le informazioni di destinazione indirizzate chiamando il metodo IVssComponent::GetDirectedTarget e lo usa per implementare il mapping dei dati di backup durante il ripristino.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vswriter.h (include Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |