CreateVssExamineWriterMetadata, fonction (vsbackup.h)

Article
08/27/2023

La fonction CreateVssExamineWriterMetadata crée un objet IVssExamineWriterMetadata .

Note Cette fonction est exportée en tant que CreateVssExamineWriterMetadataInternal, mais vous devez appeler CreateVssExamineWriterMetadata, et non CreateVssExamineWriterMetadataInternal.

Syntaxe

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Paramètres

[in] bstrXML

Chaîne XML contenant un document de métadonnées writer avec lequel initialiser l’objet IVssExamineWriterMetadata retourné.

[out] ppMetadata

Variable qui reçoit un pointeur d’interface IVssExamineWriterMetadata vers l’objet .

Valeur retournée

Les valeurs de retour répertoriées ici s’ajoutent aux HRESULT COM normaux qui peuvent être retournés à tout moment à partir de la fonction.

Valeur	Signification
S_OK	Retour réussi d’un pointeur vers une interface IVssExamineWriterMetadata .
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	Mémoire insuffisante ou autres ressources système.
VSS_E_INVALID_XML_DOCUMENT	Le document XML transmis dans le paramètre bstrXML n’est pas valide, c’est-à-dire qu’il ne s’agit pas d’une chaîne XML correctement formée ou qu’il ne correspond pas au schéma.
VSS_E_UNEXPECTED	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 enregistrer une copie du document de métadonnées writer d’un rédacteur dans une chaîne XML à transmettre au paramètre bstrXML , utilisez la méthode IVssExamineWriterMetadata::SaveAsXML .

Pour récupérer la dernière version du document de métadonnées writer d’un writer, utilisez la méthode IVssBackupComponents::GetWriterMetadata .

Pour charger un document de métadonnées writer dans un objet IVssExamineWriterMetadata existant, utilisez la méthode IVssExamineWriterMetadata::LoadFromXML .

Les utilisateurs ne doivent pas tenter de modifier le contenu du document de métadonnées writer.

L’application appelante est responsable de l’appel de IUnknown::Release pour libérer les ressources détenues par l’objet IVssExamineWriterMetadata lorsque l’objet n’est plus nécessaire.

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
DLL	VssApi.dll

Voir aussi

IVssExamineWriterMetadata

Partager via