大网数据广告活动
Windows 系统接口

SetPowerState method of the CIM_DesktopMonitor class

· 52CE 我爱测

SetPowerState method of the CIM_DesktopMonitor class - The SetPowerState method sets the desired power state for a logical device and when the device should be put into that state.

The SetPowerState method sets the desired power state for a logical device and when the device should be put into that state. In a subclass, the set of possible return codes should be specified using a ValueMap qualifier on the method. The strings to which the ValueMap contents are translated should also be specified in the subclass as a Values array qualifier. This method is inherited from CIM_LogicalDevice.

Important: The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

Syntax

uint32 SetPowerState(
  [in] uint16   PowerState,
  [in] datetime Time
);

Parameters

PowerState [in]

A ValueMap value that specifies the desired power state for this logical device.

1

Full power.

2

Power save low-power mode.

3

Power save standby.

4

Power save other.

5

Power cycle.

6

Power off.

Time [in]

Specifies when the power state should be set, either as a regular date-time value or as an interval value (where the interval begins when the method invocation is received). When the PowerState parameter is equal to 5 ("Power Cycle"), the Time parameter indicates when the device should power-on again. Power-off is immediate.

Return value

Returns 0 (zero) if successful, 1 (one) if the specified PowerState and Time request is not supported, and another value if any other error occurred.

Remarks

This method is currently not implemented by WMI. To use this method, you must implement it in your own provider.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Namespace Root\CIMV2
MOF CIMWin32.mof
DLL CIMWin32.dll

See also

CIM_DesktopMonitor

CIM_DesktopMonitor

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。