Método IConsolePower::ResetIdleTimer (mmc.h)
O método ResetIdleTimer redefine os temporizadores ociosos de gerenciamento de energia especificados.
Sintaxe
HRESULT ResetIdleTimer(
[in] DWORD dwFlags
);
Parâmetros
[in] dwFlags
Os sinalizadores usados para redefinir temporizadores ociosos. Um ou mais dos sinalizadores a seguir podem ser usados. Para obter mais informações, consulte SetThreadExecutionState.
ES_DISPLAY_REQUIRED
Redefine o temporizador ocioso de exibição (monitor).
ES_SYSTEM_REQUIRED
Redefine o temporizador ocioso do sistema.
Valor retornado
Se tiver êxito, o valor retornado será S_OK. Esse método retornará S_FALSE quando invocado em um sistema que não dá suporte ao gerenciamento de energia. Outros valores retornados indicam um código de erro.
Comentários
Chame IConsolePower::ResetIdleTimer em vez de chamar SetThreadExecutionState. Os snap-ins não devem chamar a função SetThreadExecutionState diretamente, fazendo isso causa conflitos se vários snap-ins estiverem em execução no mesmo thread. Em vez disso, os snap-ins devem chamar SetExecutionState. Redefinir um temporizador ocioso faz com que ele comece novamente no acompanhamento do período ocioso. Se um snap-in não especificar um estado de execução contínua chamando IConsolePower::SetExecutionState, ele poderá chamar periodicamente ResetIdleTimer para prolongar o tempo antes que o sistema ou exiba rotinas de gerenciamento de energia sejam invocadas.
Exemplos
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;
}
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| Biblioteca | Mmc.lib |
| DLL | Mmcndmgr.dll |