Metodo IVssBackupComponents::BackupComplete (vsbackup.h)

Articolo
08/27/2023

Il metodo BackupComplete fa sì che VSS generi un evento BackupComplete , che segnala ai writer che il processo di backup è stato completato.

Sintassi

HRESULT BackupComplete(
  [out] IVssAsync **ppAsync
);

Parametri

[out] ppAsync

Puntatore indiretto doubly a un'istanza IVssAsync .

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 . Per i valori validi restituiti dal parametro pHrResult, vedere IVssAsync::QueryStatus.
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_UNEXPECTED_WRITER_ERROR	Si è verificato un errore imprevisto durante la comunicazione con i writer. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.

Commenti

Quando si lavora in modalità componente (IVssBackupComponents::SetBackupState è stato chiamato con un argomento dei componenti selezionati true), i writer possono determinare l'esito positivo o negativo del backup di qualsiasi componente incluso in modo esplicito nei componenti del documento dei componenti di backup usando IVssComponent::GetBackupSucceeded. Pertanto, un'applicazione di backup (richiedente) ben comportata deve chiamare IVssBackupComponents::SetBackupSucceeded dopo l'elaborazione di ogni componente e prima di chiamare BackupComplete.

Non chiamare questo metodo se la chiamata a IVssBackupComponents::D oSnapshotSet non è riuscita. Per altre informazioni su come i richiedenti usano DoSnapshotSet, SetBackupSucceeded e BackupComplete in un'operazione di backup, vedere Panoramica delle attività di pre-backup e panoramica del backup effettivo dei file.

Questa operazione è asincrona. Il chiamante può usare il metodo di interfaccia QueryStatus nell'interfaccia IVssAsync restituita per determinare lo stato della notifica.

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.

L'applicazione di backup può scegliere di interrompere il backup in qualsiasi momento dopo la creazione della copia shadow chiamando IVssAsync::Cancel.

L'applicazione chiamante è responsabile della chiamata di IUnknown::Release per rilasciare le risorse contenute dall'IVssAsync restituito quando non è più necessario.

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