Fungsi RegisterPowerSettingNotification (winuser.h)

Artikel
08/27/2023

Mendaftarkan aplikasi untuk menerima pemberitahuan pengaturan daya untuk peristiwa pengaturan daya tertentu.

Sintaks

HPOWERNOTIFY RegisterPowerSettingNotification(
  [in] HANDLE  hRecipient,
  [in] LPCGUID PowerSettingGuid,
  [in] DWORD   Flags
);

Parameter

[in] hRecipient

Tangani yang menunjukkan di mana pemberitahuan pengaturan daya akan dikirim. Untuk aplikasi interaktif, parameter Bendera harus nol, dan parameter hRecipient harus menjadi handel jendela. Untuk layanan, parameter Bendera harus satu, dan parameter hRecipient harus menjadi SERVICE_STATUS_HANDLE seperti yang dikembalikan dari RegisterServiceCtrlHandlerEx.

[in] PowerSettingGuid

GUID pengaturan daya yang pemberitahuannya akan dikirim. Untuk informasi selengkapnya lihat Mendaftar untuk Power Events.

[in] Flags

Nilai	Makna
DEVICE_NOTIFY_WINDOW_HANDLE 0	Pemberitahuan dikirim menggunakan pesan WM_POWERBROADCAST dengan parameter wParamPBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	Pemberitahuan dikirim ke fungsi panggilan balik HandlerEx dengan parameter dwControlSERVICE_CONTROL_POWEREVENT dan dwEventTypedari PBT_POWERSETTINGCHANGE.

Nilai kembali

Mengembalikan handel pemberitahuan untuk membatalkan pendaftaran pemberitahuan daya. Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-powermanagement-l1-1-0 (diperkenalkan di Windows 8)

Lihat juga

Fungsi Manajemen Daya

Mendaftar untuk Power Events

UnregisterPowerSettingNotification

Bagikan melalui