Méthode SetPowerState de la classe CIM_LogicalDevice (fournisseurs WMI CIMWin32)
La méthode SetPowerState de la classe CIM_LogicalDevice définit l’état d’alimentation souhaité pour un appareil logique et le moment où un appareil doit être placé dans cet état.
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 cet appareil logique.
-
Pleine puissance (1)
-
Pleine puissance.
-
Économie d’énergie - Mode faible consommation (2)
-
Mode d’économie d’énergie faible.
-
Économie d’alimentation - Veille (3)
-
Veille de l’économie d’alimentation.
-
Économie d’énergie - Autre (4)
-
Économie d’énergie autre.
-
Cycle d’alimentation (5)
-
Cycle d’alimentation.
-
Mise hors tension (6)
-
Mettez hors tension.
Heure [in]
Spécifie quand l’état d’alimentation doit être défini, soit sous forme de valeur de date-heure régulière, soit de 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 être mis sous tension à nouveau. La mise hors tension est immédiate.
Valeur retournée
Retourne 0 (zéro) en cas de réussite, 1 (un) si la requête PowerState et Time spécifiée n’est pas prise en charge, et une autre valeur si une autre erreur s’est produite.
Notes
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 est traduit doivent également être spécifiées dans la sous-classe en tant que qualificateur de tableau Values . Cette méthode est héritée de CIM_LogicalDevice.
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.
Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du SDK Microsoft ou fournir plus d’informations.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|