Fungsi PowerSettingRegisterNotification (powersetting.h)

Artikel
03/13/2024

Mendaftar untuk menerima pemberitahuan saat pengaturan daya berubah.

Sintaks

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Parameter

[in] SettingGuid

GUID yang mewakili pengaturan daya.

[in] Flags

Informasi tentang penerima pemberitahuan. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
DEVICE_NOTIFY_SERVICE_HANDLE	Parameter Penerima adalah handel ke layanan. Gunakan fungsi CreateService atau OpenService untuk mendapatkan handel ini.
DEVICE_NOTIFY_CALLBACK	Parameter Penerima adalah penunjuk ke fungsi panggilan balik untuk dipanggil saat pengaturan daya berubah. Penerima dalam hal ini diharapkan berjenis PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS.

[in] Recipient

Handel ke penerima pemberitahuan.

[out] RegistrationHandle

Handel ke pendaftaran. Gunakan handel ini untuk membatalkan pendaftaran pemberitahuan.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal.

Keterangan

Segera setelah pendaftaran, panggilan balik akan dipanggil dengan nilai pengaturan daya saat ini. Jika pendaftaran terjadi saat pengaturan daya berubah, Anda mungkin menerima beberapa panggilan balik; panggilan balik terakhir adalah pembaruan terbaru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	powersetting.h
Pustaka	Powrprof.lib
DLL	Powrprof.dll

Lihat juga

GUID Pengaturan Daya

PowerSettingUnregisterNotification

Bagikan melalui