SetPowerState-Methode der CIM_LogicalDevice-Klasse (CIMWin32 WMI-Anbieter)
Die SetPowerState-Methode der CIM_LogicalDevice-Klasse legt den gewünschten Energiezustand für ein logisches Gerät fest, und wann ein Gerät in diesen Zustand versetzt werden soll.
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.
-
Volle Leistung (1)
-
Volle Leistung.
-
Energiesparmodus – Energiesparmodus (2)
-
Energiesparmodus.
-
Energiesparen – Standby ( 3)
-
Energiesparmodus.
-
Energiesparen – Andere (4)
-
Strom sparen andere.
-
Stromversorgung (5)
-
Einschaltvorgang.
-
Ausschalten (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
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.
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 |
|