Commands usually set error level at the end of their execution. In Windows NT and later, it is a 32-bit signed integer; in MS DOS, it used to be an integer from 0 to 255. Keywords: return code, exit code, exit status.

The conventional meaning of the error level:

• 0 - success
• not 0 - failure
• The error levels being set are usually positive.
• If the command does not distinguish various kinds of failure, the error level on failure is usually 1.

Uses of the error level:

• It can be tested using && and ||; see also syntax.
• It can be tested using IF.
• The value can be accessed from ERRORLEVEL variable.

Examples:

• dir >NUL && echo Success
  • The part after && is executed only if the error level is zero.
• color 00 || echo Failure
  • The part after || is executed only if the error level is non-zero, whether positive or negative.
• color 00 || ( echo Failure)
  • Multi-line bracketing works as well.
• echo %ERRORLEVEL%
  • Displays the error level without changing it.
• if %errorlevel% equ 0 echo The error level is zero, meaning success.
• if %errorlevel% neq 0 echo The error level is non-zero, meaning failure.
• if errorlevel 1 echo The error level is >= 1, meaning failure via positive error level.
  • Does not cover failure via negative error level. Note the >= part: this is not the same as if %errorlevel% equ 1.
• exit /b 1
  • Returns a batch file, setting the error level to 1.
• cmd /c "exit /b 10"
  • In the middle of a batch file or on the command line, sets the error level to 10.