RegisterPowerSettingNotification function
Applies to: desktop apps only
Registers the application to receive power setting notifications for the specific power setting event.
Syntax
HPOWERNOTIFY WINAPI RegisterPowerSettingNotification( __in HANDLE hRecipient, __in LPCGUID PowerSettingGuid, __in DWORD Flags );
Parameters
- hRecipient [in]
-
Handle indicating where the power setting notifications are to be sent. For interactive applications, the Flags parameter should be zero, and the hRecipient parameter should be a window handle. For services, the Flags parameter should be one, and the hRecipient parameter should be a SERVICE_STATUS_HANDLE as returned from RegisterServiceCtrlHandlerEx.
- PowerSettingGuid [in]
-
The GUID of the power setting for which notifications are to be sent. For more information see Registering for Power Events.
- Flags [in]
-
Value Meaning - DEVICE_NOTIFY_WINDOW_HANDLE
- 0
Notifications are sent using WM_POWERBROADCAST messages with a wParam parameter of PBT_POWERSETTINGCHANGE.
- DEVICE_NOTIFY_SERVICE_HANDLE
- 1
Notifications are sent to the HandlerEx callback function with a dwControl parameter of SERVICE_CONTROL_POWEREVENT and a dwEventType of PBT_POWERSETTINGCHANGE.
Return value
Returns a notification handle for unregistering for power notifications. If the function fails, the return value is NULL. To get extended error information, call GetLastError.
Requirements
|
Minimum supported client | Windows Vista |
|---|---|
|
Minimum supported server | Windows Server 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
Send comments about this topic to Microsoft
Build date: 2/7/2012
