Fungsi WritePwrScheme (powrprof.h)
[WritePwrScheme tidak lagi tersedia untuk digunakan pada Windows Vista. Sebagai gantinya, gunakan fungsi PowerEnumerate untuk menghitung setelan daya untuk skema yang ditentukan, dan fungsi tulis daya untuk menulis setelan individual.]
Menulis pengaturan kebijakan yang unik untuk skema daya yang ditentukan.
Sintaks
BOOLEAN WritePwrScheme(
[in] PUINT puiID,
[in] LPCWSTR lpszSchemeName,
[in, optional] LPCWSTR lpszDescription,
[in] PPOWER_POLICY lpScheme
);
Parameter
[in] puiID
Indeks skema daya yang akan ditulis. Jika skema daya dengan indeks yang sama sudah ada, maka akan diganti. Jika tidak, skema daya baru dibuat.
[in] lpszSchemeName
Nama skema daya.
[in, optional] lpszDescription
Deskripsi skema daya.
[in] lpScheme
Penunjuk ke struktur POWER_POLICY yang berisi pengaturan kebijakan daya yang akan ditulis.
Nilai kembali
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
Perubahan ini tidak mempengaruhi kebijakan daya sistem saat ini. Untuk menerapkan perubahan ini ke kebijakan daya sistem saat ini, panggil fungsi SetActivePwrScheme dengan indeks skema daya ini.
Skema kebijakan daya yang ditulis menggunakan WritePwrScheme disimpan secara permanen di sarang registri sistem, dan tetap tersedia untuk digunakan dalam program panel kontrol Opsi Daya, atau dengan panggilan berikutnya ke API skema daya. Untuk menghapus skema daya secara permanen dari sistem, panggil fungsi DeletePwrScheme .
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 |