Metodo IVssBackupComponentsEx::GetWriterMetadataEx (vsbackup.h)
Il metodo GetWriterMetadataEx restituisce i metadati per un'istanza del writer specifica in esecuzione nel sistema.
Sintassi
HRESULT GetWriterMetadataEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] IVssExamineWriterMetadataEx **ppMetadata
);
Parametri
[in] iWriter
Indice del writer i cui metadati devono essere recuperati. Il valore di questo parametro è un numero intero compreso tra 0 e n-1 inclusi, dove n è il numero totale di writer nel sistema corrente. Il valore di n viene restituito dal metodo IVssBackupComponents::GetWriterMetadataCount .
[out] pidInstance
Indirizzo di una variabile allocata dal chiamante che riceve l'identificatore dell'istanza del writer che ha raccolto i metadati.
[out] ppMetadata
Puntatore indiretto doubly all'istanza dell'oggetto IVssExamineWriterMetadataEx contenente i metadati restituiti.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito un puntatore a un oggetto interfaccia IVssExamineWriterMetadataEx . |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Il parametro iWriter non punta a un writer valido. |
|
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
GetWriterMetadataEx è identico al metodo IVssBackupComponents::GetWriterMetadata , ad eccezione del fatto che restituisce un puntatore all'interfaccia IVssExamineWriterMetadataEx anziché un puntatore all'interfaccia IVssExamineWriterMetadata nel parametro ppMetadata .
Un richiedente deve chiamare il metodo IVssBackupComponents::GatherWriterMetadata e attendere il completamento prima di chiamare GetWriterMetadataEx.
Anche se il metodo GatherWriterMetadata deve essere chiamato prima di un'operazione di ripristino o di backup, GetWriterMetadataEx non viene in genere chiamato per i ripristini.
Le informazioni sui componenti recuperate (durante le operazioni di backup) utilizzando il metodo IVssExamineWriterMetadata::GetComponent , in cui l'interfaccia IVssExamineWriterMetadataEx è stata restituita da GetWriterMetadataEx, proviene dal documento metadati writer di un processo di scrittura live.
Ciò è diverso dalle informazioni restituite da GetWriterComponents (durante le operazioni di ripristino), archiviate nel documento Componenti di backup tramite chiamate al metodo IVssBackupComponents::AddComponent .
Al termine dell'accesso ai metadati, il chiamante di questo metodo deve chiamare IUnknown::Release.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |