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

另请参阅

POWER_POLICY

电源管理功能

电源方案