PowerClearRequest 函数 (winbase.h)

递减电源请求对象的指定类型的电源请求计数。

语法

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

电源请求对象的句柄。

[in] RequestType

要递减的电源请求类型。此参数的取值可为下列值之一：

值	含义
PowerRequestDisplayRequired	即使长时间没有用户输入，显示器也会保持打开状态。
PowerRequestSystemRequired	系统在用户不活动一段时间后继续运行，而不是进入睡眠状态。
PowerRequestAwayModeRequired	系统进入离开模式，而不是睡眠模式。在离开模式下，系统继续运行，但关闭音频和视频以呈现睡眠状态。
PowerRequestExecutionRequired	调用进程将继续运行，而不是被进程生存期管理机制挂起或终止。允许进程运行的时间和时长取决于操作系统和电源策略设置。当 PowerRequestExecutionRequired 请求处于活动状态时，它意味着 PowerRequestSystemRequired。 PowerRequestExecutionRequired 请求类型只能由应用程序使用。服务不能使用此请求类型。 Windows 7 和 Windows Server 2008 R2：从 Windows 8 和 Windows Server 2012 开始，支持此请求类型。

如果函数成功，则返回非零值。

如果函数失败，则返回零。要获得更多的错误信息，请调用 GetLastError。