通过

IConsolePower：：ResetIdleTimer 方法 (mmc.h)

  • 项目

ResetIdleTimer 方法重置指定的电源管理空闲计时器。

语法

HRESULT ResetIdleTimer(
  [in] DWORD dwFlags
);

parameters

[in] dwFlags

用于重置空闲计时器的标志。 可以使用以下一个或多个标志。 有关详细信息，请参阅 SetThreadExecutionState。

ES_DISPLAY_REQUIRED

将显示器重置 (监视器) 空闲计时器。

ES_SYSTEM_REQUIRED

重置系统空闲计时器。

返回值

如果成功，则返回值S_OK。 在不支持电源管理的系统上调用时，此方法将返回S_FALSE。 其他返回值指示错误代码。

注解

调用 IConsolePower：：ResetIdleTimer ，而不是调用 SetThreadExecutionState。 管理单元不得直接调用 SetThreadExecutionState 函数，如果在同一线程上运行多个管理单元，则这样做会导致冲突。 相反，管理单元应调用 SetExecutionState。 重置空闲计时器会导致它在跟踪空闲时段时重新开始。 如果管理单元未通过调用 IConsolePower：：SetExecutionState 指定连续执行状态，它可以定期调用 ResetIdleTimer 以延长系统或显示电源管理例程被调用之前的时间。

示例

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;
}

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h
Library Mmc.lib
DLL Mmcndmgr.dll

另请参阅

IConsolePower：：SetExecutionState

SetThreadExecutionState