registerPowerSettingNotification 函数 (winuser.h)

  • 项目

注册应用程序以接收特定电源设置事件的电源设置通知。

语法

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

参数

[in] hRecipient

指示电源设置通知的发送位置的句柄。 对于交互式应用程序， Flags 参数应为零， hRecipient 参数应为窗口句柄。 对于服务，Flags 参数应为 1，hRecipient 参数应为从 RegisterServiceCtrlHandlerEx 返回的SERVICE_STATUS_HANDLE。

[in] PowerSettingGuid

要为其发送通知的电源设置的 GUID 。 有关详细信息，请参阅 注册 Power Events。

[in] Flags

值 含义
DEVICE_NOTIFY_WINDOW_HANDLE
0
 使用 wParam 参数为 PBT_POWERSETTINGCHANGE 的WM_POWERBROADCAST消息发送通知。
DEVICE_NOTIFY_SERVICE_HANDLE
1
 通知发送到 HandlerEx 回调函数，其中 dwControl 参数 为 SERVICE_CONTROL_POWEREVENT ， dwEventType为 PBT_POWERSETTINGCHANGE。

返回值

返回用于取消注册电源通知的通知句柄。 如果函数失败，则返回值为 NULL。 要获得更多的错误信息，请调用 GetLastError。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8 中引入的 ext-ms-win-ntuser-powermanagement-l1-1-0 ()

另请参阅

电源管理功能

注册 Power Events

UnregisterPowerSettingNotification