Método IConsolePower::ResetIdleTimer (mmc.h)
El método ResetIdleTimer restablece los temporizadores de inactividad de administración de energía especificados.
Sintaxis
HRESULT ResetIdleTimer(
[in] DWORD dwFlags
);
Parámetros
[in] dwFlags
Marcas usadas para restablecer temporizadores de inactividad. Se pueden usar una o varias de las marcas siguientes. Para obtener más información, vea SetThreadExecutionState.
ES_DISPLAY_REQUIRED
Restablece el temporizador de inactividad de pantalla (monitor).
ES_SYSTEM_REQUIRED
Restablece el temporizador de inactividad del sistema.
Valor devuelto
Si se ejecuta correctamente, se S_OK el valor devuelto. Este método devolverá S_FALSE cuando se invoque en un sistema que no admita la administración de energía. Otros valores devueltos indican un código de error.
Comentarios
Llame a IConsolePower::ResetIdleTimer en lugar de llamar a SetThreadExecutionState. Los complementos no deben llamar directamente a la función SetThreadExecutionState , lo que provoca conflictos si se ejecutan varios complementos en el mismo subproceso. En su lugar, los complementos deben llamar a SetExecutionState. El restablecimiento de un temporizador de inactividad hace que comience de nuevo en el seguimiento del período de inactividad. Si un complemento no especifica un estado de ejecución continua llamando a IConsolePower::SetExecutionState, puede llamar periódicamente a ResetIdleTimer para prolongar el tiempo antes de invocar el sistema o mostrar rutinas de administración de energía.
Ejemplos
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 compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |
| Library | Mmc.lib |
| Archivo DLL | Mmcndmgr.dll |