See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function supercedes SHIdleTimerResetby enabling the application to specify which timer gets reset.
Syntax
HRESULT WINAPI SHIdleTimerResetEx( DWORD dwFlags ); |
Parameters
- dwFlags
-
Indicates which session timer(s) to reset. Can be any combination of the timers as shown in the following table.
Value Description LOCK_SESSION
Reset device lock session timer.
HOME_SESSION
Reset home session timer (Windows Mobile Standard only).
FLUSH_SESSION
Reset flush session timer (Windows Mobile Standard only).
IDLE_SESSION
Call SystemIdleTimerReset.
Return Value
This function returns S_OK on success. Currently no failure codes are returned.
Remarks
Calling SHIdleTimerResetEx(LOCK_SESSION | HOME_SESSION | FLUSH_SESSION)is equivalent to calling SHIdleTimerReset.
SHIdleTimerResetExcan be called by applications to prevent the home screen from coming forward but still allowing device lock to function. In this case the function would be called with HOME_SESSION | FLUSH_SESSION. An example of such an application is a media player application which can call SHIdleTimerResetExwhile playing video.
Windows Mobile Professional and Windows Mobile Classic only support LOCK_SESSION and IDLE_SESSION. If IDLE_SESSION is specified, SystemIdleTimerResetwill be called which will keep the device from suspending. LOCK_SESSION is the timer that controls when the device will lock. If the device has been user idle for X amount of time the device locks. Calling this function with LOCK_SESSION periodically will prevent the device from auto locking.
HOME_SESSION is the timer that controls when the system will revert to showing the home screen on Windows Mobile Standard. Periodically calling the SHIdleTimerResetExwith HOME_SESSION will prevent the system from automatically switching back to the home screen. FLUSH_SESSION is the timer that controls the periodic flushing of the registry and databases to persistent storage. Note than on power off and suspend these are always flushed. Periodically calling this function with FLUSH_SESSION will prevent the device from performing its periodic flush to persistent storage.
Requirements
| Header | aygshell.h |
| Library | aygshell.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later, Windows Mobile 6 Standard and later |