Metodo IVssCreateExpressWriterMetadata::AddExcludeFiles (vswriter.h)

Articolo
03/09/2024

Esclude un set di file (un file o file specificato) che potrebbe altrimenti essere incluso in modo implicito quando viene eseguito il backup di un componente di un writer rapido.

Sintassi

HRESULT AddExcludeFiles(
  [in] LPCWSTR wszPath,
  [in] LPCWSTR wszFilespec,
  [in] bool    bRecursive
);

Parametri

[in] wszPath

Puntatore a una stringa di caratteri wide con terminazione Null contenente la directory radice in cui devono essere esclusi i file.

Il percorso può contenere variabili di ambiente(ad esempio, %SystemRoot%) ma non può contenere caratteri jolly.

Non è necessario che il percorso venga terminato con una barra rovesciata (\). Spetta alle applicazioni che recuperano queste informazioni da controllare.

[in] wszFilespec

Puntatore a una stringa di caratteri wide con terminazione Null contenente la specifica di file dei file da escludere.

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 modificare o false in caso contrario.This parameter should be set to true if the path is treated as a hierarchy of directories to be recursed through, or false otherwise.

Per informazioni sull'attraversamento di cartelle montate, vedere Utilizzo di cartelle montate e Reparse Points.

Valore restituito

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

Valore	Significato
S_OK	L'operazione è stata completata.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. 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

I writer express 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 del percorso (wszPath) a AddExcludeFiles (dopo la risoluzione di qualsiasi variabile di ambiente) devono essere in questo formato. Ad esempio, è spesso utile definire un componente per includere tutti i file in una directory specificata e quindi usare AddExcludeFiles per rimuovere in modo esplicito alcuni file (ad esempio, file temporanei) da un backup.

Per altre informazioni sull'esclusione dei file, vedere Escludere la specifica dell'elenco di file.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssCreateExpressWriterMetadata

IVssCreateExpressWriterMetadata::AddComponent

Condividi tramite