SetPowerState-Methode der CIM_Processor-Klasse
Die SetPowerState-Methode der CIM_Processor-Klasse legt den gewünschten Energiezustand für ein logisches Gerät fest, und wann ein Gerät in diesen Zustand versetzt werden soll. In einer Unterklasse sollte der Satz möglicher Rückgabecodes mithilfe eines ValueMap-Qualifizierers für die -Methode angegeben werden. Die Zeichenfolgen, in die die ValueMap-Inhalte übersetzt werden, sollten auch in der Unterklasse als Werte-Arrayqualifizierer angegeben werden. Diese Methode wird von CIM_LogicalDevice geerbt.
Wichtig
Die CIM-Klassen (Common Information Model) von DMTF (Distributed Management Task Force) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.
Syntax
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
Parameter
-
PowerState [in]
-
Ein ValueMap-Wert , der den gewünschten Energiezustand für dieses logische Gerät angibt.
-
1
-
Volle Leistung.
-
2
-
Energiesparmodus.
-
3
-
Energiesparmodus.
-
4
-
Strom sparen andere.
-
5
-
Einschaltvorgang.
-
6
-
Ausschalten.
Zeit [in]
Gibt an, wann der Energiezustand festgelegt werden soll, entweder als regulärer Datum-Uhrzeit-Wert oder als Intervallwert (wobei das Intervall beginnt, wenn der Methodenaufruf empfangen wird). Wenn der PowerState-Parameter gleich 5 ("Power Cycle") ist, gibt der Time-Parameter an, wann das Gerät wieder eingeschaltet werden soll. Das Ausschalten erfolgt sofort.
Rückgabewert
Gibt bei erfolgreicher Ausführung 0 (null), 1 (1) zurück, wenn die angegebene PowerState - und Time-Anforderung nicht unterstützt wird, und einen anderen Wert, wenn ein anderer Fehler aufgetreten ist.
Bemerkungen
Diese Methode wird derzeit nicht von WMI implementiert. Um diese Methode verwenden zu können, müssen Sie sie in Ihrem eigenen Anbieter implementieren.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die vom DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, den Dokumentationsstandards des Microsoft SDK zu entsprechen oder weitere Informationen bereitzustellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|