Metodo IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile (vsbackup.h)

Ottiene informazioni sui set di file esclusi in modo esplicito da una determinata copia shadow.

Sintassi

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

Parametri

[in] iFile

Indice per un set di file escluso. Il valore di questo parametro è un intero compreso tra 0 e n-1, dove n è il numero totale di set di file esclusi in modo esplicito da una determinata copia shadow. Il valore di n viene restituito dal metodo IVssExamineWriterMetadataExdataEx2::GetExcludeFromSnapshotCount .

[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
Il puntatore a un'interfaccia IVssWMFiledesc è stata restituita correttamente.
E_INVALIDARG
Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
Il chiamante non è in memoria o altre risorse di sistema.
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

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

Il metodo GetExcludeFromSnapshotFile è destinato a segnalare informazioni sui set di file esclusi da una copia shadow. I richiedenti non devono escludere i file dal backup in base alle informazioni restituite da questo metodo.

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 vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria VssApi.lib

Vedi anche

IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot

IVssExamineWriterMetadataEx2

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount