Metodo IVssCreateWriterMetadata::AddExcludeFiles (vswriter.h)

  • Articolo

Il metodo AddExcludeFiles viene usato per escludere in modo esplicito un set di file (un file o file specificato) che potrebbe essere incluso in modo implicito quando viene eseguito il backup di un componente del writer corrente.

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.

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 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 ricreare o false in caso contrario.

Per informazioni sull'attraversamento delle cartelle montate, vedere Uso di cartelle montate e punti di reparse.

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 altre risorse di sistema.
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

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) 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 determinata directory 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

   
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

IVssCreateWriterMetadata

IVssCreateWriterMetadata::AddComponent