Méthode IVssBackupComponents::SaveAsXML (vsbackup.h)
La méthode SaveAsXML enregistre le document de composants de sauvegarde contenant les informations d’état d’un demandeur dans une chaîne spécifiée. Ce document XML, qui contient le document Composants de sauvegarde, doit toujours être enregistré de manière sécurisée dans le cadre d’une opération de sauvegarde.
Syntaxe
HRESULT SaveAsXML(
[in] BSTR *pbstrXML
);
Paramètres
[in] pbstrXML
Pointeur vers une chaîne à utiliser pour stocker le document de composants de sauvegarde contenant les informations d’état d’un demandeur.
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Le document XML a été correctement enregistré en tant que valeur de paramètre pbstrXML . |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée lors d’une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte. |
|
Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place. |
Remarques
Pour une opération de sauvegarde classique, SaveAsXML ne doit pas être appelé tant que les deux enregistreurs et le demandeur n’ont pas terminé de modifier le document des composants de sauvegarde.
Les rédacteurs peuvent continuer à modifier le document des composants de sauvegarde jusqu’à leur retour réussi après la gestion de l’événement PostSnapshot (CVssWriter::OnPostSnapshot), ou de manière équivalente à l’achèvement d’IVssBackupComponents::D oSnapshotSet.
Les demandeurs devront continuer à modifier le document composants de sauvegarde au fur et à mesure que la sauvegarde progresse. En particulier, un demandeur stocke un enregistrement composant par composant de la réussite ou de l’échec de la sauvegarde par le biais d’appels à la méthode IVssBackupComponents::SetBackupSucceeded .
Une fois que le demandeur a terminé de modifier le document des composants de sauvegarde, le demandeur doit utiliser SaveAsXML pour enregistrer une copie du document sur le support de sauvegarde.
Un document de composants de sauvegarde peut être enregistré à des moments antérieurs du cycle de vie d’une opération de sauvegarde, pour instance, afin de prendre en charge la génération de clichés instantanés transportables à gérer sur des machines distantes. (Pour plus d’informations, consultez Importation de volumes copiés instantanés transportables .)
Toutefois, SaveAsXML ne doit jamais être appelé avant IVssBackupComponents::P repareForBackup, car le document des composants de sauvegarde n’aura pas été rempli par le demandeur et les rédacteurs.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothèque | VssApi.lib |
Voir aussi
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::InitializeForBackup