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
S_OK	È stato restituito un puntatore a un'istanza dell'interfaccia IVssAsync . Vedere IVssAsync::QueryStatus per i valori validi restituiti dal parametro pHrResult .
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	ppAsync non punta a un puntatore valido; vale a dire, è NULL.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	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.
VSS_E_WRITER_INFRASTRUCTURE	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.
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 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

Vedi anche

CVssWriter::OnIdentify

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents