SetPowerState-Methode der CIM_VolatileStorage Klasse

Die SetPowerState-Methode der CIM_VolatileStorage Klasse legt den gewünschten Leistungszustand für ein logisches Gerät fest und wenn 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 der ValueMap-Inhalt übersetzt wird, sollte auch in der Unterklasse als Wertearrayqualifizierer angegeben werden. Diese Methode wird von CIM_LogicalDevice geerbt.

Wichtig

Die DMTF-Klassen (Distributed Management Task Force) CIM (Common Information Model) 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 Leistungszustand für dieses logische Gerät angibt.

1

Volle Leistung.

2

Stromsparmodus mit niedriger Leistung.

3

Energiesparmodus.

4

Andere Stromsparen.

5

Stromzyklus.

6

Ausschalten.

Zeit [in]

Gibt an, wann der Stromzustand festgelegt werden soll, entweder als regulärer Datums-Uhrzeit-Wert oder als Intervallwert (wobei das Intervall beginnt, wenn die Methodenaufrufe empfangen werden). Wenn der PowerState-Parameter gleich 5 ("Power Cycle") ist, gibt der Time-Parameter an, wann das Gerät erneut eingeschaltet werden soll. Die Abschaltung ist direkt.

Rückgabewert

Gibt 0 (Null) zurück, wenn erfolgreich, 1 (eins), 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 zu verwenden, müssen Sie sie in Ihrem eigenen Anbieter implementieren.

Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von der DMTF veröffentlicht wurden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, microsoft SDK-Dokumentationsstandards zu entsprechen oder weitere Informationen bereitzustellen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Siehe auch

CIM_VolatileStorage

CIM_VolatileStorage