Metodo IVssBackupComponents::AddNewTarget (vsbackup.h)

Articolo
03/03/2024

Il metodo AddNewTarget viene usato da un richiedente durante un'operazione di ripristino per indicare che l'applicazione di backup prevede di ripristinare i file in un nuovo percorso.

Sintassi

HRESULT AddNewTarget(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE ct,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszPath,
  [in] LPCWSTR            wszFileName,
  [in] bool               bRecursive,
  [in] LPCWSTR            wszAlternatePath
);

Parametri

[in] writerId

Identificatore univoco globale (GUID) della classe writer contenente i file che devono ricevere una nuova destinazione.

[in] ct

Identifica il tipo del componente. Per informazioni sui possibili valori restituiti, vedere la documentazione per VSS_COMPONENT_TYPE .

[in] wszLogicalPath

Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente contenente i file che devono ricevere una nuova destinazione di ripristino. Per altre informazioni, vedere Percorso logico dei componenti.

Il valore della stringa contenente il percorso logico usato qui deve corrispondere a quello usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.

Il percorso logico può essere NULL.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .

[in] wszComponentName

Stringa di caratteri wide con terminazione Null contenente il nome del componente contenente i file che devono ricevere una nuova destinazione di ripristino.

La stringa non deve essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.

Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .

[in] wszPath

Stringa di caratteri wide con terminazione Null contenente il nome della directory o della gerarchia di directory contenente i file per ricevere una nuova destinazione di ripristino.

La directory può essere una directory locale nel computer VSS oppure può essere una directory di condivisione file in un file server remoto.

Il percorso può contenere variabili di ambiente(ad esempio, %SystemRoot%) ma non può contenere caratteri jolly. Sono supportati i percorsi UNC.

Non è necessario che il percorso termina con una barra rovesciata (""). Spetta alle applicazioni che recuperano queste informazioni da controllare.

[in] wszFileName

Stringa di caratteri wide con terminazione Null contenente la specifica del file dei file per ricevere una nuova destinazione di ripristino.

Una specifica di file non può contenere specifiche di directory (ad esempio, nessuna barra rovesciata) ma può contenere ? e * caratteri jolly.

[in] bRecursive

Valore booleano che indica se solo i file nella directory definita da wszPath e la corrispondenza con la specifica del file fornita da wszFileName devono ricevere una nuova destinazione di ripristino oppure se tutti i file nella gerarchia definita da wszPath e corrispondenti alla specifica del file fornita da wszFileName devono ricevere una nuova destinazione di ripristino.

Per informazioni sull'attraversamento di cartelle montate, vedere Utilizzo di cartelle montate e Reparse Points.

[in] wszAlternatePath

Stringa di caratteri wide con terminazione Null contenente il percorso completo della nuova directory di destinazione di ripristino.

La directory può essere una directory locale nel computer VSS oppure può essere una directory di condivisione file in un file server remoto.

Sono supportati i percorsi UNC.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	Aggiunta della nuova destinazione di ripristino completata.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato o questo metodo è stato chiamato durante un'operazione di ripristino.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	Il componente non esiste o il percorso e la specifica del file non corrispondono a un componente e a una specifica di file nel componente.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012.

Il nome del componente specificato come argomento per AddNewTarget (wszComponentName) deve corrispondere a un componente già aggiunto al documento Componenti di backup.

Pertanto , wszComponentName può essere il nome di qualsiasi componente incluso in modo esplicito nel documento Componenti di backup.

L'aggiunta di una nuova destinazione per il file in un sottocomponente deve essere eseguita usando il nome del componente che definisce il set di componenti contenente il sottocomponente.

Quando si specifica un file o un file per modificare la destinazione di ripristino, Un richiedente deve assicurarsi che la combinazione di percorso, specifica del file e del flag di ricorsione (wszPath, wszFileSpec e bRecursive, rispettivamente) fornita a AddNewTarget deve corrispondere a quella di uno dei set di file aggiunti a un componente usando IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles o IVssCreateWriterMetadata::AddDatabaseLogFiles.

Quando un richiedente chiama AddNewTarget, deve farlo prima di chiamare IVssBackupComponents::P reRestore. Per altre informazioni, vedere Panoramica della preparazione del ripristino.

Le informazioni sul percorso e sul descrittore di file possono essere ottenute dal documento dei metadati writer usando l'oggetto IVssWMFiledesc restituito da IVssWMComponent::GetFile, IVssWMComponent::GetDatabaseFile o IVssWMComponent::GetDatabaseLogFile. L'oggetto IVssWMComponent viene ottenuto da Writer Metadata Document dal metodo IVssExamineWriterMetadata::GetComponent .

I writer possono determinare se i file sono stati ripristinati in nuovi percorsi usando i metodi IVssComponent::GetNewTargetCount e IVssComponent::GetNewTarget .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib