Funzione RegisterSuspendResumeNotification (winuser.h)

  • Articolo

Registra per ricevere una notifica quando il sistema viene sospeso o ripreso. Analogamente a PowerRegisterSuspendResumeNotification, ma opera in modalità utente e può accettare un handle di finestra.

Sintassi

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

Parametri

[in] hRecipient

Questo parametro contiene parametri per la sottoscrizione a una notifica di alimentazione o a un handle di finestra che rappresenta il processo di sottoscrizione.

Se Flags è DEVICE_NOTIFY_CALLBACK, hRecipient viene interpretato come puntatore a una struttura DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . In questo caso, la funzione di callback è DeviceNotifyCallbackRoutine. Quando viene eseguita la funzione Callback , il parametro Type viene impostato che indica il tipo di evento che si è verificato. I valori possibili includono PBT_APMSUSPEND, PBT_APMRESUMESUSPEND e PBT_APMRESUMEAUTOMATIC . Per altre informazioni, vedere Eventi di risparmio energia. Il parametro Setting non viene usato con le notifiche di sospensione/ripresa.

Se Flags è DEVICE_NOTIFY_WINDOW_HANDLE, hRecipient è un handle per la finestra a cui recapitare gli eventi.

[in] Flags

Questo parametro può essere DEVICE_NOTIFY_WINDOW_HANDLE o DEVICE_NOTIFY_CALLBACK.

Valore restituito

Handle per la registrazione. Usare questo handle per annullare la registrazione per le notifiche.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni sull'errore estese, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione Winuser
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-powermanagement-l1-1-0 (introdotto in Windows 8)

Vedi anche

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification