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	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

CIM_LogicalDevice

CIM_LogicalDevice