CIM_UnitaryComputerSystem 類別的 SetPowerState 方法
CIM_UnitaryComputerSystem類別的 SetPowerState 方法會設定邏輯裝置所需的電源狀態，以及何時應將裝置放入該狀態。 在子類別中，應該使用 方法上的 ValueMap 限定詞來指定一組可能的傳回碼。 ValueMap內容要轉譯的字串也應該在子類別中指定為Values陣列限定詞。 這個方法繼承自 CIM_LogicalDevice。
重要
DMTF (Distributed Management Task Force) 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)
-
關閉電源。
-
休眠 (7)
-
冬眠。
-
虛關閉 (8)
-
虛關閉。
時間 [in]
指定何時應將電源狀態設定為一般日期時間值，或指定為間隔值， (在收到方法調用時開始間隔) 。 當 PowerState 參數等於 5 (「Power Cycle」) 時， Time 參數會指出裝置何時應該再次開啟電源。 關閉電源會立即關閉。
傳回值
如果成功，則傳回 0 (零) ，如果不支援指定的 PowerState 和 Time 要求，則傳回 1 (一) ，如果發生任何其他錯誤，則傳回另一個值。
備註
WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作此方法。
本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|