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 的详细信息，请参阅 电源方案。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | powrprof.h |
| Library | PowrProf.lib |
| DLL | PowrProf.dll |