Fungsi SetActivePwrScheme (powrprof.h)

  • Artikel

[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

Lihat juga

GLOBAL_POWER_POLICY

GetActivePwrScheme

POWER_POLICY

Fungsi Manajemen Daya

Skema Daya