Función RegisterPowerSettingNotification (winuser.h)
Registra la aplicación para recibir notificaciones de configuración de energía para el evento de configuración de energía específico.
Sintaxis
HPOWERNOTIFY RegisterPowerSettingNotification(
[in] HANDLE hRecipient,
[in] LPCGUID PowerSettingGuid,
[in] DWORD Flags
);
Parámetros
[in] hRecipient
Identificador que indica dónde se enviarán las notificaciones de configuración de energía. En el caso de las aplicaciones interactivas , el parámetro Flags debe ser cero y el parámetro hRecipient debe ser un identificador de ventana. En el caso de los servicios, el parámetro Flags debe ser uno y el parámetro hRecipient debe ser un SERVICE_STATUS_HANDLE tal y como se devuelve de RegisterServiceCtrlHandlerEx.
[in] PowerSettingGuid
GUID de la configuración de energía para la que se enviarán las notificaciones. Para obtener más información, consulte Registro de eventos de Power.
[in] Flags
| Valor | Significado |
|---|---|
|
Las notificaciones se envían mediante mensajes WM_POWERBROADCAST con un parámetro wParam de PBT_POWERSETTINGCHANGE. |
|
Las notificaciones se envían a la función de devolución de llamada HandlerEx con un parámetro dwControl de SERVICE_CONTROL_POWEREVENT y un dwEventType de PBT_POWERSETTINGCHANGE. |
Valor devuelto
Devuelve un identificador de notificación para anular el registro de las notificaciones de energía. Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluir Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
| Conjunto de API | ext-ms-win-ntuser-powermanagement-l1-1-0 (introducido en Windows 8) |
Consulte también
Funciones de administración de energía