Metodo IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot (vswriter.h)

  • Articolo

Segnala tutti i set di file che verranno esclusi in modo esplicito dal writer quando viene creata una copia shadow.

La chiamata a questo metodo non comporta l'esclusione dei file. Il writer è responsabile dell'eliminazione dei file dalla copia shadow nel metodo CVssWriter::OnPostSnapshot .

Sintassi

HRESULT AddExcludeFilesFromSnapshot(
  [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.

Sono supportati i percorsi UNC.

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 per verificare se il percorso termina con una barra rovesciata.

[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
0x0000000L
 L'operazione è stata completata.
E_INVALIDARG
0x80070057L
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
0x8007000EL
 Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT
0x80042311L
 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_NOT_SUPPORTED
0x8004232FL
 Questo metodo non è supportato per i writer rapidi.
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.

L'uso del metodo AddExcludeFilesFromSnapshot è facoltativo. I writer devono usare questo metodo solo per file di grandi dimensioni che cambiano in modo significativo tra le operazioni di copia shadow.

Questo metodo non sostituisce il metodo IVssCreateWriterMetadata::AddExcludeFiles . I writer devono continuare a usare il metodo AddExcludeFiles per segnalare i set di file esclusi dal backup.

Il chiamante è responsabile della chiamata del metodo IUnknown::Release per rilasciare le risorse dell'oggetto IVssWMFiledesc restituito.

Requisiti

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

Vedi anche

IVssCreateWriterMetadata::AddExcludeFiles

IVssCreateWriterMetadataEx

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile