Fonction UPSWaitForStateChange (upssvc.h)

  • Article

La fonction UPSWaitForStateChange attend qu’un état UPS spécifié change ou qu’un intervalle de délai d’attente s’écoule.

Syntaxe

void UPSWaitForStateChange(
  [in] DWORD aCurrentState,
  [in] DWORD anInterval
);

Paramètres

[in] aCurrentState

Spécifie l’état UPS sur lequel attendre. Lorsque l’état du système UPS passe de l’état spécifié à un autre état, la fonction retourne. La valeur spécifiée peut être l’une des suivantes :

UPS_ONLINE

L’alimentation fournie par l’utilitaire est normale.

UPS_ONBATTERY

L’alimentation fournie par les services publics est insuffisante et les batteries ondées se déchargent.

UPS_LOWBATTERY

L’alimentation fournie par les services publics est insuffisante et les batteries ondées sont extrêmement faibles.

UPS_NOCOMM

La communication avec l’UPS n’est actuellement pas établie.

[in] anInterval

Spécifie un intervalle de délai d’attente, en millisecondes, pour la fonction . Si l’état UPS n’a pas changé par rapport à l’état spécifié lorsque l’intervalle s’écoule, la fonction retourne. La valeur INFINITE signifie que l’intervalle ne s’écoule jamais.

Valeur de retour

None

Remarques

La fonction UPSWaitForStateChange doit attendre que l’état de l’UPS change par rapport à la valeur spécifiée par aCurrentState, soit jusqu’à ce que le temps spécifié par anInterval soit écoulé, selon la première éventualité.

Un appel à UPSCancelWait interromptUPSWaitForStateChange et provoque son retour.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête upssvc.h (inclure Upssvc.h)

Voir aussi

UPSCancelWait