-subsystemversion (Visual Basic)

Especifica a versão mínima do subsistema na qual o arquivo executável gerado pode ser executado, determinando assim as versões do Windows nas quais o arquivo executável pode ser executado. Mais comumente, essa opção garante que o arquivo executável possa aproveitar recursos de segurança específicos que não estão disponíveis com versões mais antigas do Windows.

Nota

Para especificar o subsistema em si, use a opção de compilador -target .

Sintaxe

-subsystemversion:major.minor

Parâmetros

major.minor

A versão mínima exigida do subsistema, expressa numa notação de pontos para as versões principais e secundárias. Por exemplo, você pode especificar que um aplicativo não pode ser executado em um sistema operacional mais antigo que o Windows 7 se definir o valor dessa opção como 6.01, conforme descrito na tabela mais adiante neste tópico. Você deve especificar os valores para major e minor como inteiros.

Os zeros à esquerda na versão não alteram a minor versão, mas os zeros à direita sim. Por exemplo, 6.1 e 6.01 referem-se à mesma versão, mas 6.10 refere-se a uma versão diferente. Recomendamos expressar a versão secundária como dois dígitos para evitar confusão.

Observações

A tabela a seguir lista as versões comuns do subsistema do Windows.

Versão do Windows Versão do subsistema
Windows Server 2003 5.02
Windows Vista 6,00
Windows 7 6.01
2008 Windows Server 6.01
Windows 8 6,02

Valores predefinidos

O valor padrão da opção de compilador -subsystemversion depende das condições na lista a seguir:

  • O valor padrão é 6.02 se qualquer opção do compilador na lista a seguir estiver definida:

  • O valor padrão é 6.00 se você estiver usando o MSBuild, estiver direcionando o .NET Framework 4.5 e não tiver definido nenhuma das opções do compilador especificadas anteriormente nesta lista.

  • O valor padrão é 4,00 se nenhuma das condições anteriores for verdadeira.

Definir esta opção

Para definir a opção de compilador -subsystemversion no Visual Studio, você deve abrir o arquivo .vbproj e especificar um valor para a SubsystemVersion propriedade no XML do MSBuild. Você não pode definir essa opção no IDE do Visual Studio. Para obter mais informações, consulte "Valores padrão" anteriormente neste tópico ou Propriedades comuns do projeto MSBuild.

Consulte também