Metodo IVssBackupComponents::SetRangesFilePath (vsbackup.h)

Articolo
08/27/2023

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
S_OK	Aggiunta corretta della nuova destinazione di ripristino.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato o questo metodo è stato chiamato diverso da durante un'operazione di ripristino.
VSS_E_OBJECT_NOT_FOUND	Il componente non esiste o la specifica del percorso e del file non corrispondono a una specifica del componente e del file nel componente.
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_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

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

Vedi anche

IVssBackupComponents

IVssComponent::AddPartialFile

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount

Condividi tramite