Méthode OnlineDevice de la classe CIM_LogicalDevice

La méthode OnlineDevice a été déconseillée au profit de la méthode RequestStateChange, plus générale, qui recoupe directement la fonctionnalité fournie par cette méthode.

Demande que logicalDevice soit mis en ligne (« paramètre d’entrée en ligne » = VRAI) ou mis hors connexion (= FAUX). « Connecté » indique que l’appareil est prêt à accepter les demandes, et est opérationnel et fonctionne entièrement. Dans ce cas, la propriété Availability de l’appareil est définie sur la valeur 3 (« En cous d’exécution/Puissance maximale »). « Hors connexion » indique qu’un appareil est optimisé et opérationnel, mais qu’il ne traite pas les demandes fonctionnelles. Dans un état hors connexion, un appareil peut être capable d’exécuter des diagnostics ou de générer des alertes opérationnelles. Par exemple, lorsque le bouton « Hors connexion » est poussé sur une imprimante, l’appareil n’est plus disponible pour traiter les projets d’impression, mais peut être disponible pour les diagnostics ou la maintenance.

Si cette méthode réussit, les propriétés Availability et AdditionalAvailability de l’appareil doivent refléter l’état mis à jour. Si une défaillance se produit lors de la tentative de connexion ou hors connexion de l’appareil, ce dernier doit rester dans son état actuel. IE, la demande, en cas d’échec, ne doit pas laisser l’appareil dans un état indéterminé. Lors de la restauration d’un appareil « Connexion », à partir d’un mode « Hors connexion », l’appareil doit être restauré à son dernier état « Connexion », si possible. Seul un appareil disposant d’un EnabledState/StatusInfo « Activé » et configuré peut être connecté ou mis hors connexion.

OnlineDevice doit renvoyer 0 si elle réussit, 1 si la demande n’est pas prise en charge du tout, 2 si la demande n’est pas prise en charge en raison de l’état actuel de l’appareil et d’une autre valeur si une autre erreur s’est produite. Dans une sous-classe, l’ensemble des codes de retour possibles peut être spécifié à l’aide d’un qualificateur ValueMap sur la méthode. Les chaînes dans lesquelles le contenu ValueMap sont « traduit » peuvent également être spécifiées dans la sous-classe en tant que qualificateur de tableau valeurs.

Notez que la fonction de cette méthode se chevauche avec la propriété RequestedState. RequestState a été ajouté au modèle pour conserver un enregistrement (c’est-à-dire une valeur persistante) de la dernière requête d’état. L’invocation de la méthode OnlineDevice doit définir la propriété RequestedState de manière appropriée.

Syntaxe

uint32 OnlineDevice(
  [in] boolean Online
);

Paramètres

Connecté [entrée]

Si VRAI, l’appareil est connecté, si FAUX, l’appareil est mis hors connexion.

Valeur retournée

À définir

Spécifications

Voir aussi

CIM_LogicalDevice