Funzione RegisterSuspendResumeNotification (winuser.h)

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

Vedi anche

DEVICE_NOTIFY_CALLBACK_ROUTINE

DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS

UnregisterSuspendResumeNotification