Metodo IVssBackupComponents::SaveAsXML (vsbackup.h)
Il metodo SaveAsXML salva il documento Componenti di backup contenente le informazioni sullo stato di un richiedente in una stringa specificata. Questo documento XML che contiene il documento Componenti di backup deve essere sempre salvato in modo sicuro come parte di un'operazione di backup.
Sintassi
HRESULT SaveAsXML(
[in] BSTR *pbstrXML
);
Parametri
[in] pbstrXML
Puntatore a una stringa da usare per archiviare il documento Componenti di backup contenente le informazioni sullo stato di un richiedente.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
È stato salvato correttamente il documento XML come valore del parametro pbstrXML . |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
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. |
|
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
Per un'operazione di backup tipica, SaveAsXML non deve essere chiamato fino a quando entrambi i writer e il richiedente vengono completati modificando il documento Componenti di backup.
I writer possono continuare a modificare il documento componenti di backup fino al corretto ritorno dalla gestione dell'evento PostSnapshot (CVssWriter::OnPostSnapshot) o equivalentemente al completamento di IVssBackupComponents::D oSnapshotSet.
I richiedenti dovranno continuare a modificare il documento Componenti di backup man mano che il backup viene eseguito. In particolare, un richiedente archivierà un record componente per componente dell'esito positivo o negativo del backup tramite chiamate al metodo IVssBackupComponents::SetBackupSucceeded.
Al termine della modifica del documento Componenti di backup, il richiedente deve usare SaveAsXML per salvare una copia del documento nel supporto di backup.
Un documento componenti di backup può essere salvato in punti precedenti nel ciclo di vita di un'operazione di backup, ad esempio per supportare la generazione di copie shadow trasportabili da gestire nei computer remoti. Per altre informazioni, vedere Importazione di volumi copiati shadow trasportabili .
Tuttavia, SaveAsXML non deve mai essere chiamato prima di IVssBackupComponents::P repareForBackup, perché il documento Componenti di backup non sarà stato compilato dal richiedente e dai writer.
Requisiti
| 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::GatherWriterMetadata
IVssBackupComponents::InitializeForBackup