Fungsi EnumPwrSchemes (powrprof.h)

[EnumPwrSchemes tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Aplikasi yang ditulis untuk Windows Vista dan yang lebih baru seharusnya menggunakan PowerEnumerate sebagai gantinya.]

Menghitung semua skema daya. Untuk setiap skema daya yang dijumlahkan, fungsi memanggil fungsi panggilan balik dengan informasi tentang skema daya.

Sintaks

BOOLEAN EnumPwrSchemes(
  [in] PWRSCHEMESENUMPROC lpfn,
  [in] LPARAM             lParam
);

Parameter

[in] lpfn

Penunjuk ke fungsi panggilan balik yang akan dipanggil untuk setiap skema daya yang dijumlahkan. Untuk informasi selengkapnya, lihat Keterangan.

[in] lParam

Nilai yang ditentukan pengguna untuk diteruskan ke fungsi panggilan balik.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk setiap skema daya yang dijumlahkan, fungsi panggilan balik dipanggil dengan parameter berikut:

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
);

Parameter sName dan sDesc adalah string Unicode yang dihentikan null. Parameter pp adalah penunjuk ke struktur POWER_POLICY yang berisi skema kebijakan daya. Untuk melanjutkan hingga semua skema daya telah dijumlahkan, fungsi panggilan balik harus mengembalikan TRUE. Untuk menghentikan enumerasi, fungsi panggilan balik harus mengembalikan FALSE.

Untuk informasi selengkapnya tentang menggunakan PowrProf.h, lihat Power Schemes.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	powrprof.h
Pustaka	PowrProf.lib
DLL	PowrProf.dll

Lihat juga

POWER_POLICY

Fungsi Manajemen Daya

Skema Daya