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

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification