Metodo IVssBackupComponents::SetRangesFilePath (vsbackup.h)
Il metodo SetRangesFilePath viene usato quando un'operazione di file parziale richiede un file di intervalli e tale file è stato ripristinato in un percorso diverso da quello originale.
Sintassi
HRESULT SetRangesFilePath(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] UINT iPartialFile,
[in] LPCWSTR wszRangesFile
);
Parametri
[in] writerId
Identificatore univoco globale (GUID) della classe writer contenente i file coinvolti nell'operazione di file parziale.
[in] ct
Identifica il tipo del componente. Fare riferimento a VSS_COMPONENT_TYPE per i possibili valori restituiti.
[in] wszLogicalPath
Stringa di caratteri wide con terminazione null contenente il percorso logico del componente contenente i file che partecipano all'operazione di file parziale.
Per altre informazioni, vedere Percorso logico dei componenti.
Il valore della stringa contenente il percorso logico usato qui deve essere uguale 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 partecipano all'operazione di file parziale.
La stringa non può essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
[in] iPartialFile
Numero di indice del file parziale. Il valore di questo parametro è un intero compreso tra 0 e n-1, dove n è il numero totale di file parziali associati a un determinato componente. Il valore di n viene restituito da IVssComponent::GetPartialFileCount.
[in] wszRangesFile
Stringa di caratteri wide con terminazione Null contenente il percorso completo di un file di intervalli.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Aggiunta corretta della nuova destinazione di ripristino. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato o questo metodo è stato chiamato diverso da durante un'operazione di ripristino. |
|
Il componente non esiste o la specifica del percorso e del file non corrispondono a una specifica del componente e del file nel componente. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
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
La chiamata a SetRangesFilePath non è necessaria se i file di intervalli vengono ripristinati sul posto.
Requisiti
| 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 |