Metodo IVssBackupComponents::InitializeForRestore (vsbackup.h)

  • Articolo

Il metodo InitializeForRestore inizializza l'interfaccia IVssBackupComponents in preparazione di un'operazione di ripristino.

Sintassi

HRESULT InitializeForRestore(
  [in] BSTR bstrXML
);

Parametri

[in] bstrXML

Stringa XML contenente il documento dei componenti di backup generato da un'operazione di backup e salvato da IVssBackupComponents::SaveAsXML.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore Significato
S_OK
 Inizializzato correttamente il documento specificato per il backup.
E_ACCESSDENIED
 Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
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_INVALID_XML_DOCUMENT
 Operazione di caricamento del documento XML specificato non riuscita.
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 documento XML fornito a questo metodo inizializza l'oggetto IVssBackupComponents con i metadati archiviati in precedenza da una chiamata a IVssBackupComponents::SaveAsXML. Gli utenti non devono manomettere questo documento di metadati.

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

IVssBackupComponents

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::SaveAsXML