Metodo IVssExamineWriterMetadata::GetComponent (vsbackup.h)
Il metodo GetComponent ottiene un documento di metadati writer per un componente di backup specificato.
Sintassi
HRESULT GetComponent(
[in] UINT iComponent,
[out] IVssWMComponent **ppComponent
);
Parametri
[in] iComponent
Indice per un componente. Il valore di questo parametro è un intero compreso tra 0 e n-1, dove n è il numero totale di componenti supportati da un determinato writer. Il valore di n viene restituito da IVssExamineWriterMetadata::GetFileCounts.
[out] ppComponent
Puntatore indiretto doubly a un oggetto IVssWMComponent contenente le informazioni sul componente.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito un puntatore a un'interfaccia IVssWMComponent . |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Il componente specificato non esiste. |
|
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 a IUnknown::Release per rilasciare le risorse dell'oggetto IVssWMComponent restituito.
Requisiti
| Requisito | Valore |
|---|---|
| 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 |