Fungsi PowerSettingRegisterNotification (powersetting.h)

  • Artikel

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