IConsolePower::ResetIdleTimer 메서드(mmc.h)
ResetIdleTimer 메서드는 지정된 전원 관리 유휴 타이머를 다시 설정합니다.
구문
HRESULT ResetIdleTimer(
[in] DWORD dwFlags
);
매개 변수
[in] dwFlags
유휴 타이머를 다시 설정하는 데 사용되는 플래그입니다. 다음 플래그 중 하나 이상을 사용할 수 있습니다. 자세한 내용은 SetThreadExecutionState를 참조하세요.
ES_DISPLAY_REQUIRED
디스플레이(모니터) 유휴 타이머를 다시 설정합니다.
ES_SYSTEM_REQUIRED
시스템 유휴 타이머를 다시 설정합니다.
반환 값
성공하면 반환 값이 S_OK. 이 메서드는 전원 관리를 지원하지 않는 시스템에서 호출될 때 S_FALSE 반환합니다. 다른 반환 값은 오류 코드를 나타냅니다.
설명
SetThreadExecutionState를 호출하는 대신 IConsolePower::ResetIdleTimer를 호출합니다. 스냅인은 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 |