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 的詳細資訊，請參閱 Power Schemes。

規格需求

另請參閱

POWER_POLICY

電源管理功能

電源配置