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。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | powrprof.h |
| 程式庫 | PowrProf.lib |
| Dll | PowrProf.dll |