Metodo IVssCreateWriterMetadata::AddFilesToFileGroup (vswriter.h)
Il metodo AddFilesToFileGroup aggiunge un set di file (un file o file specificato) a un componente del gruppo di file specificato.
Sintassi
HRESULT AddFilesToFileGroup(
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszGroupName,
[in] LPCWSTR wszPath,
[in] LPCWSTR wszFilespec,
[in] bool bRecursive,
[in] LPCWSTR wszAlternateLocation,
[in] DWORD dwBackupTypeMask
);
Parametri
[in] wszLogicalPath
Puntatore a una stringa di caratteri wide con terminazione null contenente il percorso logico (che può essere NULL) del componente a cui aggiungere i file. Per altre informazioni, vedere Percorso logico dei componenti.
[in] wszGroupName
Puntatore a una stringa di caratteri wide con terminazione null contenente il nome del componente del gruppo di file. Il tipo di questo componente deve essere VSS_CT_FILEGROUP; in caso contrario, il metodo restituirà un errore.
[in] wszPath
Puntatore a una stringa di caratteri wide con terminazione null contenente la directory radice predefinita dei file da aggiungere.
La directory può essere una directory locale nel computer VSS oppure può essere una directory di condivisione file in un file server remoto.
I percorsi UNC sono supportati.
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 (""). Si tratta di applicazioni che recuperano queste informazioni da controllare.
[in] wszFilespec
Puntatore a una stringa di caratteri wide con terminazione null contenente la specifica del file da includere.
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 ricreare o false in caso contrario.
Per informazioni sull'attraversamento delle cartelle montate, vedere Uso di cartelle montate e punti di reparse.
[in] wszAlternateLocation
Puntatore a una stringa di caratteri wide con terminazione null contenente il percorso alternativo, che contiene in realtà i file da eseguire il backup con questo componente.
La directory può essere una directory locale nel computer VSS oppure può essere una directory di condivisione file in un file server remoto.
I percorsi UNC sono supportati.
Se si specifica un percorso alternativo, è facoltativo; se non è necessario alcun percorso alternativo, wszAlternatePath deve essere NULL.
Un percorso alternativo non deve essere confuso con un mapping di posizioni alternativo.
[in] dwBackupTypeMask
Maschera di bit di valori di enumerazione VSS_FILE_SPEC_BACKUP_TYPE per indicare se un writer deve valutare il file per la partecipazione a un determinato tipo di operazioni di backup.
Il valore predefinito per questo argomento è (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).
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 o il chiamante ha tentato di aggiungere file di file a un componente non file-group. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Per i writer express, il valore di wszAlternatePath deve essere NULL e la maschera a bit dwBackupTypeMask non può includere VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED, VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED o VSS_FSBT_LOG_BACKUP_REQUIRED. |
|
Il componente specificato non esiste. |
|
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 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 del percorso (wszPath e wszAlternatePath) a AddFilesToFileGroup (dopo la risoluzione di qualsiasi variabile di ambiente) devono essere in questo formato.
Un writer può chiamare questo metodo più volte per aggiungere diversi set di file al componente del gruppo di file. Tuttavia, è necessario assicurarsi che le specifiche del file non si sovrapponga, perché un determinato file può essere specificato una sola volta.
I percorsi da cui vengono sottoposti a backup e a cui vengono ripristinati dipendono dai valori della directory radice definita da wszPath e dal percorso alternativo definito da wszAlternatePath.
Si noti quanto segue quando si usano le informazioni sul percorso fornite da AddFilesToFileGroup:
- Le operazioni di ripristino devono (se possibile) ripristinare i file aggiunti a un componente da AddFilesToFileGroup nella directory radice predefinita definita da wszPath.
- Se non viene specificato un percorso alternativo (se wszAlternatePath è NULL), i file aggiunti al componente verranno sottoposti a backup dalla directory radice predefinita e ripristinati nella directory radice predefinita indicata da wszPath.
- Se viene specificato un percorso alternativo (se wszAlternatePath non è NULL), i file aggiunti al componente vengono sottoposti a backup dal percorso alternativo specificato da wszAlternatePath. Tuttavia, i richiedenti useranno comunque wszPath come percorso di ripristino predefinito.
- Se il percorso alternativo è definito (wszAlternatePath è diverso da NULL) e sono presenti file corrispondenti alla specifica del file (wszFilespec) nel percorso alternativo e nella directory radice predefinita (wszPath), un'operazione di backup dovrebbe eseguire il backup dei file che si trovano nel percorso alternativo, non i file presenti nella directory radice predefinita.
- I file devono essere ripristinati nella directory indicata da wszPath a meno che non sia stato impostato un mapping di percorso alternativo da IVssCreateWriterMetadata::AddAlternateLocationMapping e il metodo di ripristino o la destinazione di ripristino lo richiede.
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 |