readPwrScheme 函数 (powrprof.h)

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

检索对指定电源方案唯一的电源策略设置。

语法

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

[in] uiID

要读取的电源方案的索引。

[out] pPowerPolicy

指向接收电源策略设置的POWER_POLICY 结构的指针。

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

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

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

若要检索有关系统当前正在使用的电源策略设置的信息，请调用 GetActivePwrScheme 函数。若要检索有关当前电源策略设置的其他信息，请调用 CallNtPowerInformation 函数。

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

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