Méthode IVssBackupComponents ::EnableWriterClasses (vsbackup.h)
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 |
|---|---|
|
Activation réussie de la classe writer. |
|
L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur. |
|
L’appelant n’a plus 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 pendant 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 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 |