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
S_OK	Impostare correttamente l'elemento.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	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

Vedi anche

IVssComponent

IVssComponent::GetDirectedTarget

IVssComponent::GetDirectedTargetCount