Metodo IVssBackupComponents::P reRestore (vsbackup.h)

  • Articolo

Il metodo PreRestore causerà la generazione di un evento PreRestore , segnalando ai writer di prepararsi per un'operazione di ripristino imminente.

Sintassi

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

Parametri

[out] ppAsync

Puntatore indiretto doubly a un oggetto IVssAsync contenente i dati di stato per l'evento segnalato.

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 codici di errore restituiti nel parametro pHrResult, vedere IVssAsync::QueryStatus.
E_INVALIDARG
 Il parametro 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.

Commenti

Il chiamante è responsabile del rilascio del puntatore dell'interfaccia IVssAsync .

È consigliabile prestare particolare attenzione ai sistemi EFI quando il richiedente ha selezionato il writer di Ripristino automatico del sistema (ASR) per il ripristino. Se si esegue il ripristino in un disco contenente la partizione EFI e si verifica una delle condizioni seguenti, è prima necessario pulire il disco chiamando il metodo IVdsAdvancedDisk::Clean :

  • Si sta ripristinando un disco di sistema EFI il cui partizionamento è stato modificato dopo l'ultimo backup asr.
  • Si esegue il ripristino in un'unità fisica diversa da quella da cui è stato eseguito il backup.
Se non si esegue questo passaggio di pulizia del disco, è possibile che si verifichino risultati imprevisti durante il PreRestore.

Per altre informazioni sul writer ASR, vedere Writer VSS in-Box.

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