SetPowerState-Methode der CIM_TapeDrive-Klasse

Artikel
06/12/2023

Die SetPowerState-Methode der CIM_TapeDrive-Klasse legt den gewünschten Energiezustand für ein logisches Gerät fest und legt fest, 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 Values-Arrayqualifizierer angegeben werden. Diese Methode wird von CIM_LogicalDevice geerbt.

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: Stromsparen andere.
5: Energiezyklus.
6: Ausschalten.

Zeit [in]

Gibt an, wann der Energiezustand festgelegt werden soll, entweder als regulärer Datums-/Uhrzeitwert 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. Die Abschaltung erfolgt sofort.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, 1 (1), 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 von der DMTF veröffentlicht werden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu korrigieren, den Microsoft SDK-Dokumentationsstandards 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	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_TapeDrive
CIM_TapeDrive