Méthode SetPowerState de la classe CIM_Controller

La méthode SetPowerState définit l’état d’alimentation souhaité pour un appareil logique et quand un appareil doit être placé dans cet état. Dans une sous-classe, l’ensemble des codes de retour possibles doit être spécifié à l’aide d’un qualificateur ValueMap sur la méthode. Les chaînes vers lesquelles le contenu ValueMap sont traduits doivent également être spécifiées dans la sous-classe en tant que qualificateur de tableau valeurs . Cette méthode est héritée de CIM_LogicalDevice.

Important

Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont générées. WMI prend actuellement en charge uniquement les schémas de version CIM 2.x.

Syntaxe

uint32 SetPowerState(
  [in] uint16   PowerState,
  [in] datetime Time
);

Paramètres

PowerState [in]

Valeur ValueMap qui spécifie l’état d’alimentation souhaité pour l’appareil logique.

1

Puissance totale.

2

Le mode d’alimentation permet d’économiser de l’alimentation.

3

Veille de l’enregistrement de l’alimentation.

4

Économisez l’alimentation d’autres.

5

Cycle d’alimentation.

6

Désactiver.

Temps [in]

Spécifie quand l’état de l’alimentation doit être défini, soit comme valeur de date-heure régulière, soit comme valeur d’intervalle (où l’intervalle commence lorsque l’appel de méthode est reçu). Lorsque le paramètre PowerState est égal à 5 (« Cycle d’alimentation »), le paramètre Time indique quand l’appareil doit se réactiver. La mise hors tension est immédiate.

Valeur retournée

Retourne 0 (zéro) si elle réussit, 1 (une) si la demande PowerState et Heure spécifiée n’est pas prise en charge, et une autre valeur si une autre erreur s’est produite.

Notes

Cette méthode n’est actuellement pas implémentée par WMI. Pour utiliser cette méthode, vous devez l’implémenter dans votre propre fournisseur. Pour plus d’informations, consultez Création de fournisseurs WMI.

Cette documentation est dérivée des descriptions de classe CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger les erreurs mineures, se conformer aux normes de documentation du Kit de développement logiciel (SDK) Microsoft ou fournir plus d’informations.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
Espace de noms
Racine\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Voir aussi

CIM_Controller

CIM_Controller