-subsystemversion (Visual Basic)
Especifica a versão mínima do subsistema no qual o arquivo executável gerado pode ser executado, determinando assim as versões do Windows em que o arquivo executável pode ser executado. Normalmente, essa opção garante que o arquivo executável possa tirar proveito de determinados recursos de segurança que não estão disponíveis com versões mais antigas do Windows.
Observação
Para especificar o subsistema em si, use a opção do compilador -target.
Sintaxe
-subsystemversion:major.minor
Parâmetros
major.minor
A versão mínima obrigatória do subsistema, conforme expresso em uma notação de ponto para 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 de major
e minor
como inteiros.
Zeros à esquerda na versão minor
não alteram a versão, mas zeros à direita alteram. Por exemplo, 6.1 e 6.01 se referem à mesma versão, mas 6.10 se refere a uma versão diferente. É recomendável expressar a versão secundária como dois dígitos para evitar confusão.
Comentários
A seguinte tabela lista as versões de subsistema comuns do Windows.
Versão do Windows | Versão do subsistema |
---|---|
Windows Server 2003 | 5,02 |
Windows Vista | 6,00 |
Windows 7 | 6.01 |
Windows Server 2008 | 6.01 |
Windows 8 | 6.02 |
Valores padrão
O valor padrão da opção do 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 for definida:
O valor padrão será 6.00 se você estiver usando o MSBuild, se tiver como destino o .NET Framework 4.5 e se não definiu nenhuma das opções de compilador que foram especificadas anteriormente na lista.
O valor padrão é 4.00 se nenhuma das condições anteriores for verdadeira.
Definindo esta opção
Para definir a opção do compilador -subsystemversion no Visual Studio, você precisa abrir o arquivo .vbproj e especificar um valor para a propriedade SubsystemVersion
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" no início deste tópico ou Propriedades de projeto comuns do MSBuild.