共用方式為

IConsolePower：：ResetIdleTimer 方法 (mmc.h)

  • 發行項

ResetIdleTimer 方法會重設指定的電源管理閒置計時器。

語法

HRESULT ResetIdleTimer(
  [in] DWORD dwFlags
);

參數

[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
程式庫 Mmc.lib
Dll Mmcndmgr.dll

另請參閱

IConsolePower：：SetExecutionState

SetThreadExecutionState