writeGlobalPwrPolicy 函数 (powrprof.h)

[WriteGlobalPwrPolicy 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。请参阅备注。]

写入全局电源策略设置。

语法

BOOLEAN WriteGlobalPwrPolicy(
  [in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

[in] pGlobalPowerPolicy

指向包含要写入的电源策略设置的GLOBAL_POWER_POLICY 结构的指针。

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

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

函数替换任何现有的全局电源策略设置。每个用户都有一个单独的全局电源方案，其中包含适用于该用户的所有电源方案的电源策略设置。

从 Windows Vista 开始，使用 PowerEnumerate 函数枚举指定方案的电源设置，并使用电源写入函数来写入各个设置。

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