Partager via


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
);

Paramètres

[in] wszData

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

Valeur retournée

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.

Remarques

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.

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

Voir aussi

IVssComponent

IVssComponent::GetBackupMetadata

IVssComponent::SetRestoreMetadata