Metodo IVssBackupComponents::InitializeForBackup (vsbackup.h)
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 |
|---|---|
|
Inizializzato correttamente il documento specificato per il backup. |
|
Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
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. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
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 |