Valor de retorno de cl.exe

cl.exe retorna zero para êxito (sem erros) e diferente de zero caso contrário.

O valor de retorno de cl.exe pode ser útil se você estiver compilando a partir de um script, powershell, .cmd ou arquivo .bat. Recomendamos que você capture a saída do compilador caso haja erros ou avisos, para que você possa resolvê-los.

Há muitos códigos de saída de erro possíveis para cl.exe listá-los todos. Você pode procurar um código de erro nos arquivos winerror.h ou ntstatus.h incluídos no Windows Software Development Kit no diretório %ProgramFiles(x86)%\Windows Kits\version\Include\shared\. Os códigos de erro retornados em decimal devem ser convertidos em hexadecimal para pesquisa. Por exemplo, um código de erro de -1073741620 convertido em hexadecimal é 0xC00000CC. Este erro é encontrado em ntstatus.h, onde a mensagem correspondente é "O nome de compartilhamento especificado não pode ser encontrado no servidor remoto." Para obter uma lista transferível de códigos de erro do Windows, consulte [MS-ERREF] Códigos de erro do Windows.

Você também pode usar o utilitário de pesquisa de erro no Visual Studio para descobrir o que significa uma mensagem de erro do compilador. Em um shell de comando do Visual Studio, digite errlook.exe para iniciar o utilitário; ou no IDE do Visual Studio, na barra de menus, escolha Ferramentas, Pesquisa de Erros. Insira o valor de erro para localizar o texto descritivo associado ao erro. Para obter mais informações, consulte Referência ERRLOOK.

Observações

A seguir está um exemplo de arquivo .bat que usa o valor de retorno de cl.exe.

echo off
cl /W4 t.cpp
@if ERRORLEVEL == 0 (
   goto good
)

@if ERRORLEVEL != 0 (
   goto bad
)

:good
   echo "clean compile"
   echo %ERRORLEVEL%
   goto end

:bad
   echo "error or warning"
   echo %ERRORLEVEL%
   goto end

:end

Ver também

Compilador MSVC Command-Line de sintaxe