CIM_LogicalDevice 類別的 SetPowerState 方法, (CIMWin32 WMI 提供者)
CIM_LogicalDevice類別的 SetPowerState 方法會設定邏輯裝置所需的電源狀態,以及何時應將裝置放入該狀態。
重要
DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。
語法
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
參數
-
PowerState [in]
-
ValueMap值,指定此邏輯裝置所需的電源狀態。
-
完整電源 (1)
-
完整電源。
-
省電 - 低電源模式 (2)
-
省電低電源模式。
-
電源儲存 - 待命 (3)
-
電源儲存待命。
-
電源儲存 - 其他 (4)
-
省電其他。
-
Power Cycle (5)
-
電源迴圈。
-
關閉電源 (6)
-
關閉電源。
時間 [in]
指定何時應將電源狀態設定為一般日期時間值,或指定為間隔值, (在收到方法調用時開始間隔) 。 當 PowerState 參數等於 5 (「Power Cycle」) 時, Time 參數會指出裝置何時應該再次開啟電源。 關閉電源是立即的。
傳回值
如果成功,則會傳回 0 (零) ,如果不支援指定的 PowerState 和 Time 要求,則傳回 1 (一個) ,如果發生任何其他錯誤,則傳回另一個值。
備註
在子類別中,應該使用 方法上的 ValueMap 限定詞來指定一組可能的傳回碼。 ValueMap內容的字串也應該在子類別中指定為Values陣列限定詞。 此方法繼承自 CIM_LogicalDevice。
WMI 目前未實作這個方法。 若要使用此方法,您必須在自己的提供者中實作它。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準,或提供詳細資訊。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\CIMV2 |
MOF |
|
DLL |
|