Fungsi WritePwrScheme (powrprof.h)

Artikel
03/01/2024

[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