Méthode IVssBackupComponents::D isableWriterClasses (vsbackup.h)

Article
08/27/2023

La méthode DisableWriterClasses empêche une classe spécifique d’enregistreurs de recevoir des événements.

Syntaxe

HRESULT DisableWriterClasses(
  [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	La classe writer a été désactivée.
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_OUTOFMEMORY	L’appelant n’a pas 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 lors d’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 vous avez plusieurs copies en cours d’exécution du même enregistreur, elles auront toutes le même identificateur de classe writer, mais elles auront des identificateurs d’enregistreur instance différents. La désactivation d’une classe writer entraîne la désactivation de toutes les instances de l’enregistreur.

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

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

Si vous appelez DisableWriterClasses plusieurs fois, chaque appel ajoute les enregistreurs du tableau rgWriterClassId à la liste des rédacteurs désactivés.

Si vous appelez DisableWriterClasses une ou plusieurs fois, puis que vous appelez EnableWriterClasses, le premier appel à EnableWriterClasses annule l’effet des appels à DisableWriterClasses et active uniquement les enregistreurs dans le tableau rgWriterClassId .

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

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

IVssBackupComponents::D isableWriterInstances

IVssBackupComponents::EnableWriterClasses

Share via