setActivePwrScheme 函数 (powrprof.h)

项目
03/01/2024

[SetActivePwrScheme 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。为 Windows Vista 及更高版本编写的应用程序应改用 PowerSetActiveScheme 。]

设置活动电源方案。

语法

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

参数

[in] uiID

要激活的电源方案的索引。

[in, optional] pGlobalPowerPolicy

指向可选 GLOBAL_POWER_POLICY 结构的指针，该结构提供在电源方案处于活动状态时要与电源方案合并的全局电源策略设置。

[in, optional] pPowerPolicy

指向可选 POWER_POLICY 结构的指针，该结构提供在电源方案处于活动状态时要与电源方案合并的电源策略设置。

返回值

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

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

注解

使用此函数对系统配置进行长期更改。若要在应用程序执行任务时暂时保持系统运行，请使用 SetThreadExecutionState 函数。

如果 uiID 指定的电源方案不存在，则函数返回零。

如果 lpGlobalPowerPolicy 为 NULL，则该函数使用 WriteGlobalPwrPolicy 设置的当前全局电源策略设置。否则，指定结构中的设置将替换当前的全局电源策略设置。

如果 lpPowerPolicy 为 NULL，则该函数使用电源方案的当前电源策略设置。否则，指定结构中的设置将替换当前电源策略设置。

有关使用 PowrProf.h 的详细信息，请参阅电源方案。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	powrprof.h
Library	PowrProf.lib
DLL	PowrProf.dll