enumPwrSchemes 函数 (powrprof.h)
[EnumPwrSchemes 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 为 Windows Vista 及更高版本编写的应用程序应改用 PowerEnumerate 。]
枚举所有电源方案。 对于枚举的每个电源方案，该函数调用一个回调函数，其中包含有关电源方案的信息。
语法
BOOLEAN EnumPwrSchemes(
[in] PWRSCHEMESENUMPROC lpfn,
[in] LPARAM lParam
);
参数
[in] lpfn
指向要为枚举的每个电源方案调用的回调函数的指针。 有关详细信息，请参阅“备注”。
[in] lParam
要传递给回调函数的用户定义值。
返回值
如果该函数成功，则返回值为非零值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
注解
对于枚举的每个电源方案，将使用以下参数调用回调函数：
typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(
UINT uiIndex, // power scheme index
DWORD dwName, // size of the sName string, in bytes
LPWSTR sName, // name of the power scheme
DWORD dwDesc, // size of the sDesc string, in bytes
LPWSTR sDesc, // description string
PPOWER_POLICY pp, // receives the power policy
LPARAM lParam // user-defined value
);
sName 和 sDesc 参数是以 null 结尾的 Unicode 字符串。 pp 参数是指向包含电源策略方案的POWER_POLICY结构的指针。 若要继续，直到枚举所有电源方案，回调函数必须返回 TRUE。 若要停止枚举，回调函数必须返回 FALSE。
有关使用 PowrProf.h 的详细信息，请参阅 电源方案。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | powrprof.h |
| Library | PowrProf.lib |
| DLL | PowrProf.dll |