Metodo IVssBackupComponents::GatherWriterStatus (vsbackup.h)

Il metodo GatherWriterStatus richiede a ogni writer di inviare un messaggio di stato.

Sintassi

HRESULT GatherWriterStatus(
  [out] IVssAsync **pAsync
);

[out] pAsync

Puntatore indiretto doubly a un oggetto IVssAsync contenente i dati sullo stato del writer.

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 in 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 oppure questo metodo non è stato chiamato all'interno della sequenza corretta.
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.
VSS_E_WRITER_INFRASTRUCTURE	L'infrastruttura del writer non funziona correttamente. Verificare che il servizio eventi e vsS siano stati avviati e verificare la presenza di errori associati a tali servizi nel log degli errori.

Il chiamante di questo metodo deve anche chiamare IVssBackupComponents::FreeWriterStatus dopo aver ricevuto lo stato di ogni writer.

Dopo aver chiamato BackupComplete, i richiedenti devono chiamare GatherWriterStatus per impostare la sessione del writer su uno stato completato.

Nota Questa operazione è necessaria solo in Windows Server 2008 con Service Pack 2 (SP2) e versioni precedenti.

La classe CVssWriter gestisce il messaggio di stato inviato da ogni writer.

Il chiamante è responsabile del rilascio dell'interfaccia IVssAsync .

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