Metodo IVssBackupComponents::GatherWriterMetadata (vsbackup.h)
Il metodo GatherWriterMetadata richiede a ogni writer di inviare i metadati raccolti. Il metodo genererà un eventoIdentifi per comunicare con writer.
Sintassi
HRESULT GatherWriterMetadata(
[out] IVssAsync **pAsync
);
Parametri
[out] pAsync
Puntatore indiretto doubly a un oggetto IVssAsync contenente i metadati del writer.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato restituito un puntatore a un'istanza dell'interfaccia IVssAsync . Vedere IVssAsync::QueryStatus per i valori validi restituiti dal parametro pHrResult . |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
ppAsync non punta a un puntatore valido; vale a dire, è NULL. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
L'infrastruttura writer non funziona correttamente. Verificare che sia stato avviato il servizio eventi e VSS e verificare la presenza di errori associati a tali servizi nel log degli errori. |
|
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 del rilascio dell'interfaccia IVssAsync .
GatherWriterMetadata deve essere chiamato una sola volta durante la durata di un determinato oggetto IVssBackupComponents .
GatherWriterMetadata genera un eventoIdentifi, gestito da ogni istanza di ogni writer tramite il metodo CVssWriter::OnIdentify , utilizzato per riempire il documento dei metadati del writer.
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 |