Metodo IVssExamineWriterMetadata::GetExcludeFile (vsbackup.h)

  • Articolo

Il metodo GetExcludeFile ottiene informazioni sui file che sono stati esplicitamente esclusi dal backup per un determinato writer.

Sintassi

HRESULT GetExcludeFile(
  [in]  UINT           iFile,
  [out] IVssWMFiledesc **ppFiledesc
);

Parametri

[in] iFile

Indice per un set di file escluso. Il valore di questo parametro è un numero intero compreso tra 0 e n-1 inclusi, dove n è il numero totale di set di file esclusi in modo esplicito dai componenti di un determinato writer. Il valore di n viene restituito da IVssExamineWriterMetadata::GetFileCounts.

[out] ppFiledesc

Puntatore indiretto doubly a un oggetto IVssWMFiledesc contenente le informazioni sull'elemento file.

Valore restituito

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

Valore Significato
S_OK
 È stato restituito un puntatore a un'interfaccia IVssWMFiledesc .
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_OBJECT_NOT_FOUND
 Il set di file specificato per l'esclusione non esiste.
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

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

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

Requisiti

   
Client minimo supportato Windows XP [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

IVssExamineWriterMetadata

IVssExamineWriterMetadata::GetFileCounts