Direcionando seu aplicativo para o Windows

  • Artigo

No Windows 8.1 e posterior, as funções GetVersion e GetVersionEx foram preteridas. A partir de Windows 10, a função VerifyVersionInfo também é preterida. Você ainda pode chamar as funções preteridas, mas se o aplicativo não direcionar especificamente Windows 8.1 ou posterior, as funções retornarão a versão do Windows 8 (6.2).

Observação

As funções GetVersion, GetVersionEx, VerifyVersionInfo e Version Helper são apenas para aplicativos da área de trabalho. Os aplicativos Universais do Windows podem usar a propriedade AnalyticsInfo.VersionInfo para telemetria e logs de diagnóstico.

Para que seu aplicativo tenha como destino Windows 8.1 ou posterior, você precisará incluir um manifesto do aplicativo (executável) para o executável do aplicativo. Em seguida, na <seção de compatibilidade> do manifesto, você precisará adicionar um <elemento COM SUPORTE> para cada versão do Windows à qual deseja declarar que seu aplicativo dá suporte.

O exemplo a seguir mostra um arquivo de manifesto do aplicativo para um aplicativo que dá suporte a todas as versões do Windows do Windows Vista para Windows 11:

<!-- example.exe.manifest -->
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3">
    <assemblyIdentity
        type="win32"
        name="Contoso.ExampleApplication.ExampleBinary"
        version="1.2.3.4"
        processorArchitecture="x86"
    />
    <description>Contoso Example Application</description>
    <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
        <application>
            <!-- Windows 10 and Windows 11 -->
            <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}"/>
            <!-- Windows 8.1 -->
            <supportedOS Id="{1f676c76-80e1-4239-95bb-83d0f6d0da78}"/>
            <!-- Windows 8 -->
            <supportedOS Id="{4a2f28e3-53b9-4441-ba9c-d69d4a4a6e38}"/>
            <!-- Windows 7 -->
            <supportedOS Id="{35138b9a-5d96-4fbd-8e2d-a2440225f93a}"/>
            <!-- Windows Vista -->
            <supportedOS Id="{e2011457-1546-43c5-a5fe-008deee3d3f0}"/> 
        </application>
    </compatibility>
    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
        <security>
            <requestedPrivileges>
                <!--
                  UAC settings:
                  - app should run at same integrity level as calling process
                  - app does not need to manipulate windows belonging to
                    higher-integrity-level processes
                  -->
                <requestedExecutionLevel
                    level="asInvoker"
                    uiAccess="false"
                />   
            </requestedPrivileges>
        </security>
    </trustInfo>
</assembly>

Declarar suporte para Windows 8.1 ou posterior no manifesto do aplicativo não terá nenhum efeito ao executar seu aplicativo em sistemas operacionais anteriores.

O manifesto do aplicativo acima também inclui uma <seção trustInfo>, que especifica como o sistema deve tratá-lo em relação ao UAC (Controle de Conta de Usuário). Adicionar trustInfo não é essencial, mas é altamente recomendável, mesmo quando seu aplicativo não precisa de nenhum comportamento relacionado ao UAC específico. Em particular, se você não adicionar trustInfo , as versões x86 de 32 bits do seu aplicativo estarão sujeitas à virtualização de arquivo UAC, o que permite que gravações em pastas com privilégios de administrador, como as pastas do sistema Windows, tenham êxito quando falharem, mas as redirecionará para uma pasta "VirtualStore" específica do usuário.