Méthode IConsolePowerSink ::OnPowerBroadcast (mmc.h)
La méthode OnPowerBroadcast traite WM_POWERBROADCAST messages de notification liés à la gestion de l’alimentation de l’ordinateur.
Syntaxe
HRESULT OnPowerBroadcast(
[in] UINT nEvent,
[in] LPARAM lParam,
[out] LRESULT *plReturn
);
Paramètres
[in] nEvent
Identificateur d’événement power broadcast. L’identificateur est l’une des valeurs suivantes.
PBT_APMBATTERYLOW
La puissance de la batterie est faible.
PBT_APMOEMEVENT
Un événement défini par OEM s’est produit.
PBT_APMPOWERSTATUSCHANGE
Power status a changé.
PBT_APMQUERYSUSPEND
Demande d’autorisation de suspension.
PBT_APMQUERYSUSPENDFAILED
Demande de suspension refusée.
PBT_APMRESUMEAUTOMATIC
Reprise automatique de l’opération après l’événement.
PBT_APMRESUMECRITICAL
Reprise de l’opération après une suspension critique.
PBT_APMRESUMESUSPEND
Reprise de l’opération après la suspension.
PBT_APMSUSPEND
Le système suspend l’opération.
[in] lParam
Données spécifiques à la fonction. Pour la plupart des événements, ce paramètre est réservé et non utilisé. Toutefois, si nEvent est l’un des événements de reprise (PBT_APMRESUME*), le paramètre lParam peut spécifier l’indicateur PBTF_APMRESUMEFROMFAILURE. Cet indicateur indique qu’une opération de suspension a échoué après la diffusion de l’événement PBT_APMSUSPEND .
[out] plReturn
Au retour, la réponse du composant logiciel enfichable à l’événement de diffusion. En règle générale, définissez *plReturn surTRUE. L’exception est lorsque nEvent est PBT_APMQUERYSUSPEND. Pour permettre à la suspension de l’ordinateur de continuer en réponse à l’événement PBT_APMQUERYSUSPEND, définissez *plReturn sur TRUE ; pour refuser la suspension de l’ordinateur, définissez *plReturn sur BROADCAST_QUERY_DENY. Un composant logiciel enfichable qui autorise la suspension de l’ordinateur doit effectuer les préparations de suspension nécessaires avant de revenir de cette méthode.
Valeur retournée
En cas de réussite, la valeur de retour est S_OK. D’autres valeurs de retour indiquent un code d’erreur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |