Méthode IVssBackupComponents ::EnableWriterClasses (vsbackup.h)

  • Article

La méthode EnableWriterClasses permet aux rédacteurs spécifiés de recevoir tous les événements.

Syntaxe

HRESULT EnableWriterClasses(
  [in] const VSS_ID *rgWriterClassId,
  [in] UINT         cClassId
);

Paramètres

[in] rgWriterClassId

Tableau contenant un ou plusieurs identificateurs de classe writer.

[in] cClassId

Nombre d’entrées dans le tableau rgWriterClassId .

Valeur retournée

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

Valeur Signification
S_OK
 Activation réussie de la classe writer.
E_ACCESSDENIED
 L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
 L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée pendant une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte.
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

Si la méthode EnableWriterClasses et la méthode IVssBackupComponents ::D isableWriterClasses ne sont jamais appelées, toutes les classes writer sont activées.

Une fois le premier appel à EnableWriterClasses retourné, les classes writer qui ont été spécifiées dans le tableau rgWriterClassId sont activées et toutes les autres classes writer sont désactivées.

Si vous appelez EnableWriterClasses plusieurs fois, chaque appel ajoute les enregistreurs du tableau rgWriterClassId à la liste des enregistreurs activés.

Si vous appelez EnableWriterClasses une ou plusieurs fois, puis que vous appelez DisableWriterClasses, l’appel à DisableWriterClasses désactive tous les enregistreurs du tableau rgWriterClassId qui ont été activés dans les appels à EnableWriterClasses.

Si vous appelez EnableWriterClasses, vous devez le faire avant d’appeler la méthode IVssBackupComponents ::GatherWriterMetadata . Si vous appelez d’abord GatherWriterMetadata , puis appelez EnableWriterClasses, l’appel à EnableWriterClasses n’a aucun effet. Si vous devez d’abord appeler GatherWriterMetadata, pour déterminer les classes d’enregistreur à activer, vous devez l’appeler à partir d’un autre instance de l’interface IVssBackupComponents.

Configuration requise

Condition requise Valeur
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

IVssBackupComponents ::D isableWriterClasses

IVssBackupComponents ::D isableWriterInstances