Метод IConsolePower::ResetIdleTimer (mmc.h)

Статья
08/24/2023

Метод 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
Header	mmc.h
Библиотека	Mmc.lib
DLL	Mmcndmgr.dll

См. также раздел

IConsolePower::SetExecutionState

SetThreadExecutionState

Поделиться через