readGlobalPwrPolicy 函数 (powrprof.h)

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

检索当前全局电源策略设置。

语法

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

[out] pGlobalPowerPolicy

指向接收信息的 GLOBAL_POWER_POLICY 结构的指针。

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

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

GLOBAL_POWER_POLICY结构包含所有电源方案通用的策略设置。此结构包含用户和计算机策略设置。

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

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