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
值 | 含义 |
---|---|
|
使用 wParam 参数为 PBT_POWERSETTINGCHANGE 的WM_POWERBROADCAST消息发送通知。 |
|
通知发送到 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 () |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈