Fonction RegisterSuspendResumeNotification (winuser.h)
S’inscrit pour recevoir une notification lorsque le système est suspendu ou repris. Similaire à PowerRegisterSuspendResumeNotification, mais fonctionne en mode utilisateur et peut prendre un handle de fenêtre.
Syntaxe
HPOWERNOTIFY RegisterSuspendResumeNotification(
[in] HANDLE hRecipient,
[in] DWORD Flags
);
Paramètres
[in] hRecipient
Ce paramètre contient des paramètres pour l’abonnement à une notification d’alimentation ou à un handle de fenêtre représentant le processus d’abonnement.
Si Flags est DEVICE_NOTIFY_CALLBACK, hRecipient est interprété comme un pointeur vers une structure DEVICE_NOTIFY_SUBSCRIBE_PARAMETERS . Dans ce cas, la fonction de rappel est DeviceNotifyCallbackRoutine. Lorsque la fonction Callback s’exécute, le paramètre Type est défini indiquant le type d’événement qui s’est produit. Les valeurs possibles incluent PBT_APMSUSPEND, PBT_APMRESUMESUSPEND et PBT_APMRESUMEAUTOMATIC . Pour plus d’informations, consultez Événements de gestion de l’alimentation . Le paramètre Setting n’est pas utilisé avec les notifications de suspension/reprise.
Si Flags est DEVICE_NOTIFY_WINDOW_HANDLE, hRecipient est un handle de la fenêtre vers laquelle remettre des événements.
[in] Flags
Ce paramètre peut être DEVICE_NOTIFY_WINDOW_HANDLE ou DEVICE_NOTIFY_CALLBACK.
Valeur retournée
Handle de l’inscription. Utilisez ce handle pour annuler l’inscription aux notifications.
Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-powermanagement-l1-1-0 (introduit dans Windows 8) |
Voir aussi
DEVICE_NOTIFY_CALLBACK_ROUTINE