Compartir a través de

Función RegisterSuspendResumeNotification (winuser.h)

  • Artículo

Se registra para recibir notificaciones cuando el sistema se suspende o reanuda. Similar a PowerRegisterSuspendResumeNotification, pero funciona en modo de usuario y puede tomar un identificador de ventana.

Sintaxis

HPOWERNOTIFY RegisterSuspendResumeNotification(
  [in] HANDLE hRecipient,
  [in] DWORD  Flags
);

Parámetros

[in] hRecipient

Este parámetro contiene parámetros para suscribirse a una notificación de energía o un identificador de ventana que representa el proceso de suscripción.

Si Flags es DEVICE_NOTIFY_CALLBACK, hRecipient se interpreta como puntero a una estructura de DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . En este caso, la función de devolución de llamada es DeviceNotifyCallbackRoutine. Cuando se ejecuta la función Callback , el parámetro Type se establece que indica el tipo de evento que se produjo. Los valores posibles incluyen PBT_APMSUSPEND, PBT_APMRESUMESUSPEND y PBT_APMRESUMEAUTOMATIC : consulte Eventos de administración de energía para obtener más información. El parámetro Setting no se usa con notificaciones de suspensión o reanudación.

Si Flags es DEVICE_NOTIFY_WINDOW_HANDLE, hRecipient es un identificador de la ventana a la que se van a entregar eventos.

[in] Flags

Este parámetro puede ser DEVICE_NOTIFY_WINDOW_HANDLE o DEVICE_NOTIFY_CALLBACK.

Valor devuelto

Identificador del registro. Use este identificador para anular el registro de las notificaciones.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.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

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification