Fungsi RegisterSuspendResumeNotification (winuser.h)

  • Artikel

Mendaftar untuk menerima pemberitahuan ketika sistem ditangguhkan atau dilanjutkan. Mirip dengan PowerRegisterSuspendResumeNotification, tetapi beroperasi dalam mode pengguna dan dapat mengambil handel jendela.

Sintaks

HPOWERNOTIFY RegisterSuspendResumeNotification(
  [in] HANDLE hRecipient,
  [in] DWORD  Flags
);

Parameter

[in] hRecipient

Parameter ini berisi parameter untuk berlangganan pemberitahuan daya atau handel jendela yang mewakili proses berlangganan.

Jika BenderaDEVICE_NOTIFY_CALLBACK, hRecipient ditafsirkan sebagai penunjuk ke struktur DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . Dalam hal ini, fungsi panggilan balik adalah DeviceNotifyCallbackRoutine. Saat fungsi Callback dijalankan, parameter Jenis diatur menunjukkan jenis peristiwa yang terjadi. Nilai yang mungkin termasuk PBT_APMSUSPEND, PBT_APMRESUMESUSPEND, dan PBT_APMRESUMEAUTOMATIC - lihat Peristiwa Manajemen Power untuk informasi selengkapnya. Parameter Pengaturan tidak digunakan dengan pemberitahuan tangguhkan/lanjutkan.

Jika BenderaDEVICE_NOTIFY_WINDOW_HANDLE, hRecipient adalah handel ke jendela untuk mengirimkan peristiwa.

[in] Flags

Parameter ini dapat DEVICE_NOTIFY_WINDOW_HANDLE atau DEVICE_NOTIFY_CALLBACK.

Mengembalikan nilai

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

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Persyaratan

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

Lihat juga

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

Membatalkan pendaftaranSuspendResumeNotification