Metodo IVssComponent::AddPartialFile (vswriter.h)

Articolo
03/13/2024

Il metodo AddPartialFile indica che è necessario eseguire il backup solo di parti di un determinato file e quali parti sono.

Solo un writer può chiamare questo metodo e solo durante un'operazione di backup.

Sintassi

HRESULT AddPartialFile(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilename,
  [in] LPCWSTR wszRanges,
  [in] LPCWSTR wszMetadata
);

Parametri

[in] wszPath

Stringa di caratteri wide con terminazione Null contenente il percorso del file coinvolto nelle operazioni di file parziali.

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.

Questo percorso deve corrispondere o essere sotto il percorso di un set di file già nel componente (o uno dei relativi sottocomponenti se il componente definisce un set di componenti).

[in] wszFilename

Stringa di caratteri wide con terminazione Null contenente il nome del file coinvolto nelle operazioni di file parziali. Il nome del file (wszFilename) non può contenere caratteri jolly (* o ?) e deve essere coerente con la specifica del file di un set di file contenente il percorso di origine (wszPath).

[in] wszRanges

Stringa di caratteri wide con terminazione Null contenente un elenco di offset e lunghezze di file che costituiscono l'intervallo di supporto file parziale (le sezioni del file di cui eseguire effettivamente il backup) o il nome di un file contenente tale elenco.

È necessario specificare l'intervallo di supporto file parziale e questo valore non può essere NULL.

[in] wszMetadata

Stringa di caratteri wide con terminazione Null contenente tutti i metadati aggiuntivi richiesti da un writer per convalidare un'operazione di ripristino parziale dei file. Le informazioni contenute in questa stringa di metadati saranno opache per i richiedenti.

Se non sono necessari metadati aggiuntivi, questo valore può essere NULL.

Valore restituito

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

Valore	Significato
S_OK	Impostare correttamente l'elemento.
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	Il metodo non è stato chiamato da un writer o, se chiamato da un writer, non è stato chiamato durante un'operazione di ripristino.

Commenti

Solo un writer può chiamare questo metodo e il writer non può chiamare questo metodo durante un'operazione di ripristino.

La sintassi dell'elenco di intervalli (wszRanges) è quella di un elenco delimitato da virgole del formato offset1:length1, offset2:length2, in cui ogni offset e lunghezza è un intero a 64 bit specificando rispettivamente un offset di byte e una lunghezza in byte. L'offset e la lunghezza possono essere espressi come valori esadecimali o decimali.

Se wszRange fa riferimento a un file contenente tutti gli offset e le lunghezze (un file di intervalli), wszRange conterrà solo il percorso completo del file.

Un file di intervalli deve essere un file binario con il formato seguente:

Intero a 64 bit che indica il numero di intervalli di file distinti di cui è necessario eseguire il backup
Ogni intervallo espresso come coppia di interi a 64 bit: l'offset nel file di cui viene eseguito il backup in byte e la lunghezza dei dati a partire da tale offset di cui eseguire il backup

In entrambi i casi, un intervallo indica una sottosezione di un determinato file di cui eseguire il backup, indipendentemente dal resto del file.

I richiedenti possono recuperare le informazioni sui file parziali usando IVssComponent::GetPartialFile e usare le informazioni sull'offset e sulla lunghezza restituite da GetPartialFile per ripristinare le sezioni di cui è stato eseguito il backup nel percorso appropriato all'interno della copia del file sul disco in fase di ripristino.

AddPartialFile può essere applicato a un file già gestito dal componente (o uno dei relativi sottocomponenti se il componente definisce un set di componenti) oppure può aggiungere un nuovo file al componente e indicare che parteciperà a operazioni di file parziali.

Quando si indica che il file a cui partecipare è un nuovo file, tale file deve esistere in un volume copiato dall'ombreggiatura e il relativo percorso (wszPath) deve corrispondere o essere sotto un percorso già presente nel componente (o uno dei relativi sottocomponenti se il componente definisce un set di componenti). Tuttavia, la specifica del file del file (wszFileSpec) non deve corrispondere a quella nei componenti.

Tutti i file appena aggiunti non supporteranno i mapping di percorsi alternativi.

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

Vedi anche

IVssBackupComponents::SetRangesFilePath

IVssComponent

IVssComponent::GetPartialFile

IVssComponent::GetPartialFileCount