CIM_LogicalDevice クラスの SetPowerState メソッド (CIMWin32 WMI プロバイダー)
CIM_LogicalDevice クラスの SetPowerState メソッドは、論理デバイスに必要な電源状態を設定し、デバイスをその状態にするタイミングを設定します。
重要
DMTF (分散管理タスク フォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョン スキーマのみがサポートされています。
構文
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
パラメーター
-
PowerState [in]
-
この論理デバイスに必要な電源状態を指定する ValueMap 値。
-
フル パワー (1)
-
フルパワー。
-
省電力 - 低電力モード (2)
-
低電力モードを保存します。
-
省電力 - スタンバイ (3)
-
スタンバイを保存します。
-
省電力 - その他 (4)
-
その他の電源を節約します。
-
電源サイクル (5)
-
電源サイクル。
-
電源オフ (6)
-
電源をオフにします。
Time [in]
通常の日時値または間隔値 (メソッド呼び出しを受け取ったときに間隔が開始される) として、電源状態を設定するタイミングを指定します。 PowerState パラメーターが 5 ("Power Cycle") に等しい場合、Time パラメーターはデバイスの電源を再びオンにするタイミングを示します。 電源オフは即時です。
戻り値
成功した場合は 0 (ゼロ)、指定された PowerState 要求と Time 要求がサポートされていない場合は 1 (1)、その他のエラーが発生した場合は別の値を返します。
解説
サブクラスでは、メソッドで ValueMap 修飾子を使用して、可能なリターン コードのセットを指定する必要があります。 ValueMap の内容が変換される文字列は、サブクラスで Values 配列修飾子として指定する必要もあります。 このメソッドは、 CIM_LogicalDeviceから継承されます。
このメソッドは現在、WMI によって実装されていません。 このメソッドを使用するには、独自のプロバイダーで実装する必要があります。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供に変更を加えた可能性があります。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|