Condividi tramite


Metodo IVssBackupComponents::P repareForBackup (vsbackup.h)

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

Vedi anche

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::StartSnapshotSet

IVssComponent