CIM_Controller 類別的 SetPowerState 方法

  • 發行項

SetPowerState方法會設定邏輯裝置所需的電源狀態，以及何時應將裝置放入該狀態。 在子類別中，應該使用 方法上的 ValueMap 限定詞來指定一組可能的傳回碼。 ValueMap內容的字串也應該在子類別中指定為Values陣列限定詞。 此方法繼承自 CIM_LogicalDevice。

重要

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

省電其他。

5

電源迴圈。

6

關閉電源。

時間 [in]

指定何時應將電源狀態設定為一般日期時間值，或指定為間隔值， (在收到方法調用時開始間隔) 。 當 PowerState 參數等於 5 (「Power Cycle」) 時， Time 參數會指出裝置何時應該再次開啟電源。 關閉電源是立即的。

傳回值

如果成功，則會傳回 0 (零) ，如果不支援指定的 PowerState 和 Time 要求，則傳回 1 (一個) ，如果發生任何其他錯誤，則傳回另一個值。

備註

WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。 如需詳細資訊，請參閱 建立 WMI 提供者。

本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
命名空間
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

CIM_Controller

CIM_Controller