Metodo IVssBackupComponents::P repareForBackup (vsbackup.h)

Articolo
03/13/2024

Il metodo PrepareForBackup causerà la generazione di un evento PrepareForBackup , segnalando i writer per preparare un'operazione di backup imminente. In questo modo, il documento componenti di backup di un richiedente è disponibile per i writer.

Sintassi

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

Parametri

[out] ppAsync

Puntatore indiretto doubly a un'istanza dell'interfaccia IVssAsync usata per determinare quando l'operazione asincrona è stata completata.

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 codici di errore restituiti nel parametro pHrResult .
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_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

PrepareForBackup genera un evento PrepareForBackup , gestito da ogni istanza di ogni writer tramite il metodo CVssWriter::OnPrepareBackup .

Prima di chiamare PrepareForBackup , è necessario chiamare IVssBackupComponents::SetBackupState .

Il documento Componenti di backup può comunque essere modificato dai writer nel gestore eventi PrepareForBackup (CVssWriter::OnPrepareBackup) e successivamente fino alla generazione di un evento BackupComplete .

Il chiamante è responsabile del rilascio dell'interfaccia IVssAsync .

Requisiti

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