Méthode IVssComponent::SetBackupMetadata (vswriter.h)

La méthode SetBackupMetadata définit les métadonnées de sauvegarde avec le composant.

Un enregistreur peut appeler cette méthode uniquement pendant une opération de sauvegarde.

Cette méthode ne peut pas être appelée lors de la gestion d’un événement BackupComplete (CVssWriter::OnBackupComplete) ou BackupShutdown (CVssWriter::OnBackupShutdown).

Syntaxe

HRESULT SetBackupMetadata(
  [in] LPCWSTR wszData
);

[in] wszData

Chaîne de caractères larges terminée par NULL qui contient les métadonnées de sauvegarde.

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK	Définissez correctement l’élément.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_OBJECT_ALREADY_EXISTS	Les métadonnées privées ont déjà été écrites pour ce composant.
VSS_E_BAD_STATE	Cette méthode n’a pas été appelée par un enregistreur ou, si elle est appelée par un enregistreur, elle n’a pas été appelée lors d’une opération de sauvegarde ou a été appelée lors de la gestion d’un événement BackupComplete ou BackupShutdown.

SetBackupMetadata définit des métadonnées privées spécifiques à un enregistreur décrivant une opération de sauvegarde.

Le format n’a pas besoin de se conformer à une spécification de métadonnées VSS.


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	vswriter.h (inclure Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib