Metodo IVssCreateWriterMetadata::AddAlternateLocationMapping (vswriter.h)
Il metodo AddAlternateLocationMapping crea un mapping di percorso alternativo per un set di file.
Sintassi
HRESULT AddAlternateLocationMapping(
[in] LPCWSTR wszSourcePath,
[in] LPCWSTR wszSourceFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszDestination
);
Parametri
[in] wszSourcePath
Stringa di caratteri wide con terminazione Null contenente il nome della directory o della gerarchia di directory contenente i file di cui eseguire il mapping.
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.
Non è necessario che il percorso termina con una barra rovesciata (""). Spetta alle applicazioni che recuperano queste informazioni da controllare.
[in] wszSourceFilespec
Stringa di caratteri wide con terminazione Null contenente la specifica del file di cui eseguire il mapping.
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 specifica se il percorso specificato dal parametro wszPath identifica solo una singola directory o se indica una gerarchia di directory da attraversare in modo ricorsivo. Questo parametro deve essere impostato su true se il percorso viene considerato come una gerarchia di directory da attraversare in modo ricorsivo o false in caso contrario.
Per informazioni sull'attraversamento di cartelle montate, vedere Utilizzo di cartelle montate e Reparse Points.
[in] wszDestination
Stringa di caratteri wide con terminazione Null contenente il percorso completo della directory in cui verranno rilocati i file.
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 |
|---|---|
|
L'operazione è stata completata. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Il metodo IVssCreateWriterMetadata::SetRestoreMethod non è stato chiamato prima della chiamata di questo metodo. |
|
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. I writer supportano solo le risorse locali: set di file il cui percorso assoluto inizia con una specifica del volume locale valida e non può essere un'unità di rete mappata. Pertanto, gli input di percorso (wszPath e wszDestination) a AddAlternateLocationMapping (dopo la risoluzione di qualsiasi variabile di ambiente) devono essere in questo formato.
Questo metodo può essere chiamato più volte per aggiungere il mapping per più file.
Combinazione di percorso, specifica del file e flag di ricorsione (wszPath, wszFileSpec e bRecursive forniti rispettivamente a AddAlternateLocationMapping da mappare devono corrispondere a uno dei set di file aggiunti a uno dei componenti del writer tramite IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles o IVssCreateWriterMetadata::AddDatabaseMetadata::AddDatabaseLogFiles.
Il metodo AddAlternateLocationMapping deve essere chiamato solo dopo la chiamata di IVssCreateWriterMetadata::SetRestoreMethod .
Un file deve essere sempre ripristinato nel relativo mapping di percorso alternativo se una delle condizioni seguenti è vera:
- Il metodo di ripristino (impostato in fase di backup) è VSS_RME_RESTORE_TO_ALTERNATE_LOCATION.
- La destinazione di ripristino è stata impostata (in fase di ripristino) su VSS_RT_ALTERNATE.
Un file può essere ripristinato in un mapping di percorso alternativo se si verifica una delle condizioni seguenti:
- Il metodo di ripristino è VSS_RME_RESTORE_IF_NOT_THERE e una versione del file è già presente sul disco.
- Il metodo di ripristino è VSS_RME_RESTORE_IF_CAN_REPLACE e una versione del file è presente su disco e non può essere sostituita.
Un mapping di percorso alternativo viene usato solo durante un'operazione di ripristino e non deve essere confuso con un percorso alternativo, che viene usato solo durante un'operazione di backup.
Per altre informazioni sui percorsi dei file di backup e ripristino in VSS, vedere Percorsi di backup e ripristino non predefiniti.
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 |