Función RegisterPowerSettingNotification (winuser.h)

Artículo
08/27/2023

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
DEVICE_NOTIFY_WINDOW_HANDLE 0	Las notificaciones se envían mediante mensajes WM_POWERBROADCAST con un parámetro wParam de PBT_POWERSETTINGCHANGE.
DEVICE_NOTIFY_SERVICE_HANDLE 1	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

Registro para eventos de Power

Anular el registroPowerSettingNotification

Share via