CIM_AggregatePSExtent クラスの SetPowerState メソッド
SetPowerState メソッドは、論理デバイスの目的の電源状態と、デバイスをその状態にする必要があるタイミングを定義します。 サブクラスでは、 メソッドの ValueMap 修飾子を使用して、使用可能なリターン コードのセットを指定する必要があります。 ValueMap の内容が変換される文字列は、サブクラスで Values 配列修飾子として指定する必要もあります。 このメソッドは 、CIM_LogicalDeviceから継承されます。
重要
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 (電源サイクル) に等しい場合、Time パラメーターはデバイスの電源を再びオンにするタイミングを示します。 電源オフは即時です。
戻り値
成功した場合は 0 (ゼロ) を返し、指定された PowerState 要求と Time 要求がサポートされていない場合は 1 (1) を返し、他のエラーが発生した場合は別の値を返します。
注釈
このメソッドは現在、WMI では実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。
このドキュメントは、DMTF によって発行された CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーの修正、Microsoft SDK ドキュメント標準への準拠、または詳細情報の提供を行うために変更を加えた可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| 名前空間 |
Root\CIMV2 |
| MOF |
|
| [DLL] |
|