RegisterSuspendResumeNotification 函数 (winuser.h)
注册以在系统暂停或恢复时接收通知。 类似于 PowerRegisterSuspendResumeNotification,但在用户模式下运行,可以采用窗口句柄。
语法
HPOWERNOTIFY RegisterSuspendResumeNotification(
[in] HANDLE hRecipient,
[in] DWORD Flags
);
参数
[in] hRecipient
此参数包含用于订阅电源通知的参数或表示订阅进程的窗口句柄。
如果标志DEVICE_NOTIFY_CALLBACK,hRecipient 将解释为指向DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS结构的指针。 在这种情况下,回调函数为 DeviceNotifyCallbackRoutine。 执行 Callback 函数时,将设置 Type 参数,指示发生的事件类型。 可能的值包括 PBT_APMSUSPEND、 PBT_APMRESUMESUSPEND和 PBT_APMRESUMEAUTOMATIC - 有关详细信息,请参阅 电源管理事件 。 Setting 参数不用于暂停/恢复通知。
如果标志DEVICE_NOTIFY_WINDOW_HANDLE,则 hRecipient 是要传送事件的窗口的句柄。
[in] Flags
此参数可以 DEVICE_NOTIFY_WINDOW_HANDLE 或 DEVICE_NOTIFY_CALLBACK。
返回值
注册的句柄。 使用此句柄取消注册通知。
如果函数失败,则返回值为 NULL。 若要获取扩展错误信息,请调用 GetLastError。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h |
Library | User32.lib |
DLL | User32.dll |
API 集 | 在 Windows 8) 中引入的 ext-ms-win-ntuser-powermanagement-l1-1-0 ( |
另请参阅
DEVICE_NOTIFY_CALLBACK_ROUTINE