ErrorLevel - Definition & Usage

ErrorLevel

명령어의 성공 여부를 알리기 위해 설정되는 내장 변수 입니다 (모든 명령어가 ErrorLevel의 값을 변경하는 것은 아닙니다). 값이 0이면 보통 성공을 나타내고, 다른 값은 보통 실패를 나타냅니다. ErrorLevel의 값을 직접 설정해도 됩니다.

RunWait가 자신이 실행한 프로그램의 종료 코드가 되도록 ErrorLevel를 설정하는 것은 특별히 흥미롭습니다. 대부분의 프로그램은 성공적으로 완료하면 종료 코드를 0으로 산출합니다.

각 쓰레드마다 자신의 ErrorLevel을 보유합니다. 현재 쓰레드가 다른 쓰레드에 의해 인터럽트 되더라도, 원래 쓰레드가 재개하면, 여전히 자신의 원래 ErrorLevel을 보유합니다. 인터럽트 한 쓰레드가 설정한 ErrorLevel이 아니라는 뜻입니다.

주의: 어떤 명령어는 ErrorLevel에 1보다 큰 값을 설정하므로, ErrorLevel이 1인가를 점검하지 말고, 대신에 ErrorLevel이 0이 아닌가를 점검하는 것이 좋습니다.

The following list contains all commands, functions and GUI/Control events which set ErrorLevel, including the possible ErrorLevel values:

Language element	ErrorLevel values
ClipWait	0, 1
Control	0, 1
ControlClick	0, 1
ControlFocus	0, 1
ControlGet	0, 1
ControlGetFocus	0, 1
ControlGetText	0, 1
ControlMove	0, 1
ControlSend / ControlSendRaw	0, 1
ControlSetText	0, 1
DllCall()	0, -1, -2, -3, -4, n, An
Drive	0, 1
DriveGet	0, 1
EnvSet	0, 1
EnvUpdate	0, 1
FileAppend	0, 1
FileCopy	0, n
FileCopyDir	0, 1
FileCreateDir	0, 1
FileCreateShortcut	0, 1
FileDelete	0, n
FileGetAttrib	0, 1
FileGetShortcut	0, 1
FileGetSize	0, 1
FileGetTime	0, 1
FileGetVersion	0, 1
FileInstall	0, 1
FileMove	0, n
FileMoveDir	0, 1
FileRead	0, 1
FileReadLine	0, 1
FileRecycle	0, 1
FileRecycleEmpty	0, 1
FileRemoveDir	0, 1
FileSelectFile	0, 1
FileSelectFolder	0, 1
FileSetAttrib	0, n
FileSetTime	0, 1
GroupActivate	0, 1
Gui: GuiSize event	0, 1, 2
Gui: GuiDropFiles event	0, n
GuiControl	0, 1
GuiControlGet	0, 1
Gui control: Link click event	문자열
Gui control: Custom event	0, n
Gui control: ListView item change event	subset of "SsFfCc"
Hotkey	0, 1, 2, 3, 4, 5, 6, 98, 99
ImageSearch	0, 1, 2
IniDelete	0, 1
IniWrite	0, 1
Input	0, 1, NewInput, Max, Timeout, Match, EndKey:Name
InputBox	0, 1, 2
KeyWait	0, 1
Menu	0, 1
PixelGetColor	0, 1
PixelSearch	0, 1, 2
PostMessage	0, 1
Process	0, PID
RegDelete	0, 1
RegExMatch()	0, 문자열, -n
RegExReplace()	0, 문자열, -n
RegRead	0, 1
RegWrite	0, 1
Run	0, ERROR
RunWait	n, ERROR
SendMessage	FAIL, n
SetWorkingDir	0, 1
Sort: U option	0, n
SoundGet	0, 문자열
SoundGetWaveVolume	0, 1
SoundPlay	0, 1
SoundSet	0, 문자열
SoundSetWaveVolume	0, 1
StatusBarGetText	0, 1
StatusBarWait	0, 1, 2
StringGetPos	0, 1
StringReplace	0, 1, n
UrlDownloadToFile	0, 1
WinGetText	0, 1
WinMenuSelectItem	0, 1
WinSet Style/ExStyle/Region	0, 1
WinWait	0, 1
WinWaitActive / WinWaitNotActive	0, 1
WinWaitClose	0, 1

Language element

ErrorLevel values

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

ControlSend / ControlSendRaw

0, 1

ControlSetText

0, 1

DllCall()

0, -1, -2, -3, -4, n, An

0, 1

0, 1

0, 1

0, 1

0, 1

0, n

0, 1

0, 1

0, 1

0, n

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, n

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, 1

0, n

0, 1

0, 1

0, 1, 2

Gui: GuiDropFiles event

0, n

GuiControl

0, 1

GuiControlGet

0, 1

Gui control: Link click event

문자열

Gui control: Custom event

0, n

Gui control: ListView item change event

subset of "SsFfCc"

Hotkey

0, 1, 2, 3, 4, 5, 6, 98, 99

0, 1, 2

0, 1

0, 1

0, 1, NewInput, Max, Timeout, Match, EndKey:Name

0, 1, 2

0, 1

0, 1

0, 1, 2

0, 1

0, PID

0, 1

0, 문자열, -n

0, 문자열, -n

0, 1

0, 1

0, ERROR

n, ERROR

FAIL, n

0, 1

0, n

0, 문자열

0, 1

0, 1

0, 문자열

0, 1

0, 1

0, 1, 2

0, 1

0, 1, n

0, 1

0, 1

0, 1

WinSet Style/ExStyle/Region

0, 1

WinWait

0, 1

WinWaitActive / WinWaitNotActive

0, 1

WinWaitClose

0, 1

예제

Waits a maximum of 1 second until MyWindow exists. If WinWait times out, ErrorLevel is set to 1, otherwise to 0.

WinWait, MyWindow,, 1
if ErrorLevel   ; 즉, 비어 있지 않거나 0이면.
    MsgBox, 창이 존재하지 않습니다.
else
    MsgBox, 창이 존재합니다.