Metodo IVssComponent::GetDirectedTarget (vswriter.h)

Articolo
03/03/2024

Il metodo GetDirectedTarget restituisce informazioni archiviate da un writer, in fase di backup, nel documento Componenti di backup per indicare che quando un file deve essere ripristinato, il file di origine deve essere ripristinato. Il file può essere ripristinato in una nuova destinazione di ripristino e/o intervalli di dati ripristinati in posizioni diverse con la destinazione di ripristino.

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetDirectedTarget(
  [in]  UINT iDirectedTarget,
  [out] BSTR *pbstrSourcePath,
  [out] BSTR *pbstrSourceFileName,
  [out] BSTR *pbstrSourceRangeList,
  [out] BSTR *pbstrDestinationPath,
  [out] BSTR *pbstrDestinationFilename,
  [out] BSTR *pbstrDestinationRangeList
);

Parametri

[in] iDirectedTarget

Numero di indice della destinazione diretta. Il valore di questo parametro è un intero compreso tra 0 e n-1, dove n è il numero totale di destinazioni dirette associate a un determinato componente (e i relativi sottocomponenti se definisce un set di componenti). Il valore di n viene restituito da IVssComponent::GetDirectedTargetCount.

[out] pbstrSourcePath

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il percorso della directory che in fase di backup contiene il file da ripristinare (il 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).

[out] pbstrSourceFileName

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il nome del file (in fase di backup) che deve essere ripristinata durante un ripristino (il file di origine). Il nome di questo file non deve contenere caratteri jolly e deve essere membro dello stesso set di file del percorso di origine (pbstrSourcePath).

[out] pbstrSourceRangeList

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente un elenco delimitato da virgole di offset e lunghezze dei file che indicano l'intervallo di supporto del 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.

[out] pbstrDestinationPath

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il percorso del quale i dati del file di origine verranno ricompressi in fase di ripristino.

[out] pbstrDestinationFilename

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il nome del file a cui verranno ripristinati i dati del file di origine.

[out] pbstrDestinationRangeList

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	Restituito correttamente il valore dell'attributo.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	L'elemento specificato non è stato trovato.

Commenti

Se la chiamata a GetDirectedTarget ha esito positivo, il chiamante è responsabile della liberazione di ogni stringa restituita chiamando la funzione SysFreeString .

Un richiedente userà le informazioni di destinazione dirette archiviate nel documento Componenti di backup solo se la destinazione di ripristino è VSS_RT_DIRECTED.

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.

I file le cui destinazioni dirette vengono restituite da GetDirectedTarget possono essere membri dei file del componente corrente o di qualsiasi sottocomponente che definisce.

Il chiamante deve liberare la memoria contenuta dai parametri pbstrSourcePath, pbstrSourceFileName, pbstrSourceRangeList, pbstrDestinationPath, pbstrDestinationFilename e pbstrDestinationRangeList chiamando SysFreeString.

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.

Il richiedente dovrà verificare se il file di origine di destinazione diretto è stato eseguito il backup come file parziale per implementare correttamente il ripristino. Se si tratta del caso, il richiedente usa le informazioni di destinazione dirette in combinazione con le informazioni sul file parziale (IVssComponent::GetPartialFile) 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::AddDirectedTarget

IVssComponent::GetDirectedTargetCount