CIM_UserDevice クラスの SetPowerState メソッド
CIM_UserDevice クラスの 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 ("Power Cycle") に等しい場合、Time パラメーターはデバイスの電源を再びオンにするタイミングを示します。 電源オフは即時です。
戻り値
成功した場合は 0 (ゼロ) を返し、指定された PowerState 要求と Time 要求がサポートされていない場合は 1 (1) を返し、他のエラーが発生した場合は別の値を返します。
注釈
現在、このメソッドは WMI によって実装されていません。 このメソッドを使用するには、独自のプロバイダーに実装する必要があります。
このドキュメントは、DMTF によって公開されている CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーを修正したり、Microsoft SDK ドキュメントの標準に準拠したり、詳細情報を提供したりするために変更を加えた可能性があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
名前空間 |
Root\CIMV2 |
MOF |
|
[DLL] |
|