Fungsi SetActivePwrScheme (powrprof.h)
[SetActivePwrScheme tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Aplikasi yang ditulis untuk Windows Vista dan yang lebih baru harus menggunakan PowerSetActiveScheme sebagai gantinya.]
Mengatur skema daya aktif.
Sintaks
BOOLEAN SetActivePwrScheme(
[in] UINT uiID,
[in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
[in, optional] PPOWER_POLICY pPowerPolicy
);
Parameter
[in] uiID
Indeks skema daya yang akan diaktifkan.
[in, optional] pGlobalPowerPolicy
Penunjuk ke struktur GLOBAL_POWER_POLICY opsional, yang menyediakan pengaturan kebijakan daya global untuk digabungkan dengan skema daya saat aktif.
[in, optional] pPowerPolicy
Penunjuk ke struktur POWER_POLICY opsional, yang menyediakan pengaturan kebijakan daya untuk digabungkan dengan skema daya saat aktif.
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
Gunakan fungsi ini untuk membuat perubahan jangka panjang pada konfigurasi sistem. Untuk sementara menjaga sistem tetap berjalan saat aplikasi melakukan tugas, gunakan fungsi SetThreadExecutionState .
Jika skema daya yang ditentukan oleh uiID tidak ada, fungsi mengembalikan nol.
Jika lpGlobalPowerPolicy adalah NULL, fungsi menggunakan pengaturan kebijakan daya global saat ini yang ditetapkan oleh WriteGlobalPwrPolicy. Jika tidak, pengaturan dalam struktur yang ditentukan menggantikan pengaturan kebijakan daya global saat ini.
Jika lpPowerPolicyadalah NULL, fungsi menggunakan pengaturan kebijakan daya saat ini untuk skema daya. Jika tidak, pengaturan dalam struktur yang ditentukan menggantikan pengaturan kebijakan daya saat ini.
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 |