Indicates that the system cannot be shut down and sets a reason string to be displayed to the user if system shutdown is initiated
#include <WinAPISys.au3>
_WinAPI_ShutdownBlockReasonCreate ( $hWnd, $sText )
| $hWnd | Handle to the main window of the application. |
| $sText | The string which explaining the reason the application must block system shutdown. |
| Success: | True |
| Failure: | False |
This function can only be called from the thread that created the window specified by the $hWnd parameter,
otherwise, the function fails and the last error code is ERROR_ACCESS_DENIED (5).
Applications should call this function as they begin an operation that cannot be interrupted, such as burning
a CD or DVD. When the operation has completed, call the _WinAPI_ShutdownBlockReasonDestroy() function to
indicate that the system can be shut down.
This function requires Windows Vista or later.
_WinAPI_ShutdownBlockReasonDestroy
Search ShutdownBlockReasonCreate in MSDN Library.
#include <ButtonConstants.au3>
#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>
#include <WinAPISys.au3>
#include <WindowsConstants.au3>
If Number(_WinAPI_GetVersion()) < 6.0 Then
MsgBox(($MB_ICONERROR + $MB_SYSTEMMODAL), 'Error', 'Require Windows Vista or later.')
Exit
EndIf
Global $g_hForm = GUICreate('Test ' & StringReplace(@ScriptName, '.au3', '()'), 200, 200)
Local $idButton = GUICtrlCreateButton('', 73, 62, 54, 54, $BS_ICON)
GUICtrlSetImage(-1, @SystemDir & '\shell32.dll', 45)
GUICtrlSetTip(-1, 'Log off ' & @UserName)
Local $idCheck = GUICtrlCreateCheckbox('Block Windows shutdown', 10, 173, 144, 21)
GUIRegisterMsg($WM_QUERYENDSESSION, 'WM_QUERYENDSESSION')
GUISetState(@SW_SHOW)
; Set the highest shutdown priority for the current process to prevent closure the other processes.
_WinAPI_SetProcessShutdownParameters(0x03FF)
While 1
Switch GUIGetMsg()
Case $GUI_EVENT_CLOSE
ExitLoop
Case $idButton
Shutdown(0)
Case $idCheck
If GUICtrlRead($idCheck) = $GUI_CHECKED Then
_WinAPI_ShutdownBlockReasonCreate($g_hForm, 'This application is blocking system shutdown because the saving critical data is in progress.')
Else
_WinAPI_ShutdownBlockReasonDestroy($g_hForm)
EndIf
EndSwitch
WEnd
Func WM_QUERYENDSESSION($hWnd, $iMsg, $wParam, $lParam)
#forceref $iMsg, $wParam, $lParam
Switch $hWnd
Case $g_hForm
If _WinAPI_ShutdownBlockReasonQuery($g_hForm) Then
Return 0
EndIf
EndSwitch
Return $GUI_RUNDEFMSG
EndFunc ;==>WM_QUERYENDSESSION