Méthode IVssBackupComponents ::D isableWriterInstances (vsbackup.h)
La méthode DisableWriterInstances désactive un writer instance ou des instances spécifiés.
Syntaxe
HRESULT DisableWriterInstances(
[in] const VSS_ID *rgWriterInstanceId,
[in] UINT cInstanceId
);
Paramètres
[in] rgWriterInstanceId
Tableau contenant un ou plusieurs identificateurs instance writer.
[in] cInstanceId
Nombre d’entrées dans le tableau rgWriterInstanceId .
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
La classe writer a été activée avec succès. |
|
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 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 instance d’un writer n’entraîne pas la désactivation des autres instances de l’enregistreur.
Si vous appelez DisableWriterInstances, vous devez le faire avant d’appeler la méthode IVssBackupComponents ::GatherWriterMetadata . Si vous appelez d’abord GatherWriterMetadata , puis disableWriterInstances, l’appel à DisableWriterInstances n’a aucun effet. Si vous devez d’abord appeler GatherWriterMetadata, pour déterminer les instances d’enregistreur à désactiver, 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 ::D isableWriterClasses