Méthode IVssBackupComponents::D isableWriterClasses (vsbackup.h)
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 |
|---|---|
|
La classe writer a été désactivée. |
|
L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
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. |
|
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 |