Introduction:

Sleep apnea is not normally a good thing, but I needed to prevent our workstations from going to sleep. Our domain workstations were going to sleep in the middle of 3rd party model runs, and group policy overrode any local power settings.

What problem does this solution solve?

This Visual Basic (2010) utility uses the SetThreadExecutionState API to inform the system that it is in use, thereby preventing the system from entering sleep or turning off the display while the application is running. The system automatically detects activities such as local keyboard or mouse input, server activity, and changing window focus (which all will keep a system from going to sleep). But disk, CPU activity and video display are activities that are not automatically detected (and a long running process is not enough to keep a system awake).

How does the code work?

The application calls the SetThreadExecutionState API once when the form is loaded. The system will not sleep (or turn off the display) as long as this application is running.

  ' API call to prevent sleep (until the application exits)
  Private Declare Function uses the SetThreadExecutionState Lib "kernel32" (ByVal esflags As EXECUTION_STATE) As EXECUTION_STATE

  ' Define the API execution states
  Private Enum EXECUTION_STATE
    ES_SYSTEM_REQUIRED = &H1    ' Stay in working state by resetting display idle timer
    ES_DISPLAY_REQUIRED = &H2   ' Force display on by resetting system idle timer
    ES_CONTINUOUS = &H80000000  ' Force this state until next ES_CONTINUOUS call and one of the other flags are cleared
  End Enum

  ' Prevents sleep as form loads
  Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles Me.Load
    No_Sleep()
  End Sub

  ' Call API - force no sleep and no display turn off
  Private Function No_Sleep() As EXECUTION_STATE
    Return SetThreadExecutionState(EXECUTION_STATE.ES_SYSTEM_REQUIRED Or EXECUTION_STATE.ES_CONTINUOUS Or EXECUTION_STATE.ES_DISPLAY_REQUIRED)
  End Function

API execution states (ES_SYSTEM_REQUIRED, ES_DISPLAY_REQUIRED, and ES_CONTINUOUS) are explained at http://msdn.microsoft.com/en-us/library/windows/desktop/aa373208%28v=vs.85%29.aspx

A button on the form flashes red every five seconds (users like to know something is happening)

No_Sleep.JPG 

  ' Flash button (so users know it's still running)
  Private Sub NoSleep_Timer_Tick(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles NoSleep_Timer.Tick
    Dim Save_Backcolor As Color = Status_Button.BackColor
    Status_Button.BackColor = Color.Red
    Me.Update()
    Thread.Sleep(500)   ' keeps button red for time
    Status_Button.BackColor = Save_Backcolor
    Me.Update()
  End Sub

Users can double click on the application to minimize the application to the system tray. A balloon tip is displayed when it's minimized so users know which icon is used.

No_Sleep_NotifyIcon.JPG 

  ' Minimize to tray if form double clicked
  Private Sub Form1_DoubleClick(sender As Object, e As System.EventArgs) Handles Me.DoubleClick
    MinimizeAppToTray()
  End Sub

  ' hide application form
  Private Sub MinimizeAppToTray()
    Me.Hide()
    NoSleep_NotifyIcon.Visible = True
    ' Show ballon text for time when app minimized
    NoSleep_NotifyIcon.ShowBalloonTip(16000)
  End Sub

Users can double click on the system tray icon to show the application window again, or right click on the icon to close the application (see full source code for these functions).

Points of Interest

This was tested and works on Windows XP, (and both 32/64 bit) Vista and Windows 7 systems.

Here are the check sums of the no_sleep.exe compiled application (VERIFY FILE INTEGRITY PRIOR TO EXECUTING, or recompile to be on the safe side).

		MD5				SHA-1
-------------------------------- ----------------------------------------
8397eb0bd800b2ed16dce95c92d2646c 0e679fcb8ef3e34f7528ecb72f963b7d33810a37

History

Version 1 posted 25 Nov 2011

Version 2 posted 27 Nov 2011 (changed source code zip file name - with same code)

推荐.NET配套的通用数据层ORM框架:CYQ.Data 通用数据层框架
新浪微博粉丝精灵,刷粉丝、刷评论、刷转发、企业商家微博营销必备工具"