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 |
|
DLL |
|