Metodo IVssBackupComponents::InitializeForBackup (vsbackup.h)

  • Articolo

Il metodo InitializeForBackup inizializza i metadati dei componenti di backup in preparazione del backup.

Sintassi

HRESULT InitializeForBackup(
  [in] BSTR bstrXML
);

Parametri

[in] bstrXML

Facoltativo. Durante le importazioni di copie shadow trasportate, questo parametro deve essere il documento originale generato durante la creazione della copia shadow salvata e salvato usando 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
 Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
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.

Per altre informazioni su come usare InitializeForBackup con copie shadow trasportabili, vedere Importazione di volumi copiati shadow trasportabili.

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::SaveAsXML