Méthode IConsolePower::ResetIdleTimer (mmc.h)
La méthode ResetIdleTimer réinitialise les minuteurs d’inactivité de gestion de l’alimentation spécifiés.
Syntaxe
HRESULT ResetIdleTimer(
[in] DWORD dwFlags
);
Paramètres
[in] dwFlags
Indicateurs utilisés pour réinitialiser les minuteurs d’inactivité. Un ou plusieurs des indicateurs suivants peuvent être utilisés. Pour plus d’informations, consultez SetThreadExecutionState.
ES_DISPLAY_REQUIRED
Réinitialise le minuteur d’inactivité d’affichage (moniteur).
ES_SYSTEM_REQUIRED
Réinitialise le minuteur d’inactivité du système.
Valeur retournée
En cas de réussite, la valeur de retour est S_OK. Cette méthode retourne S_FALSE lorsqu’elle est appelée sur un système qui ne prend pas en charge la gestion de l’alimentation. D’autres valeurs de retour indiquent un code d’erreur.
Notes
Appelez IConsolePower::ResetIdleTimer au lieu d’appeler SetThreadExecutionState. Les composants logiciels enfichables ne doivent pas appeler directement la fonction SetThreadExecutionState , ce qui entraîne des conflits si plusieurs composants logiciels enfichables s’exécutent sur le même thread. Au lieu de cela, les composants logiciels enfichables doivent appeler SetExecutionState. La réinitialisation d’un minuteur d’inactivité l’amène à recommencer dans le suivi de la période d’inactivité. Si un composant logiciel enfichable ne spécifie pas d’état d’exécution continue en appelant IConsolePower::SetExecutionState, il peut régulièrement appeler ResetIdleTimer pour prolonger le délai avant l’appel du système ou afficher les routines de gestion de l’alimentation.
Exemples
HRESULT hr;
// Reset both the display and system idle timers.
// pConsolePower was created previously by
// the CoCreateInstance method.
hr = pConsolePower->ResetIdleTimer(
ES_DISPLAY_REQUIRED | ES_SYSTEM_REQUIRED);
switch (hr)
{
case S_OK:
OutputDebugString(_T("ResetIdleTimer: Succeeded\n"));
break;
case S_FALSE:
// The system does not support power management.
OutputDebugString(_T("ResetIdleTimer: Unsupported\n"));
break;
default:
// Unexpected error occurred.
OutputDebugString(_T("ResetIdleTimer: Failure\n"));
break;
}
Spécifications
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| Bibliothèque | Mmc.lib |
| DLL | Mmcndmgr.dll |