Поделиться через


Назначение приложения для Windows

В Windows 8.1 и более поздних версиях функции GetVersion и GetVersionEx устарели. По состоянию на Windows 10 функция VerifyVersionInfo также не рекомендуется. Вы по-прежнему можете вызывать устаревшие функции, но если приложение не предназначено специально для Windows 8.1 или более поздней версии, функции будут возвращать версию Windows 8 (6.2).

Заметка

GetVersion, GetVersionEx, VerifyVersionInfo, а функции вспомогательных версий предназначены только для настольных приложений. Универсальные приложения Windows могут использовать свойство AnalyticsInfo.VersionInfo для журналов телеметрии и диагностики.

Чтобы ваше приложение было предназначено для Windows 8.1 или более поздней версии, необходимо включить манифест приложения (исполняемый) для его исполняемого файла. Затем в разделе <совместимости> манифеста необходимо добавить элемент <поддерживаемого> OS для каждой версии Windows, которую вы хотите объявить, что ваше приложение поддерживает.

В следующем примере показан файл манифеста приложения для приложения, поддерживающего все версии Windows из Windows Vista в 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>

Объявление поддержки Windows 8.1 или более поздней версии в манифесте приложения не будет иметь никакого эффекта при запуске приложения в предыдущих операционных системах.

Приведенный выше манифест приложения также содержит раздел <trustInfo>, который указывает, как система должна обрабатывать его в отношении Управления учетными записями пользователей (UAC). Добавление trustInfo не является важным, но настоятельно рекомендуется, даже если приложению не требуется определенное поведение, связанное с UAC. В частности, если вы совсем не добавляете trustInfo, то 32-разрядные версии вашего приложения для x86 будут подвергаться виртуализации файлов UAC, что позволяет успешную запись в папки с правами администратора, такие как системные папки Windows, когда в противном случае это завершилось бы ошибкой, но при этом перенаправляет их в индивидуальную для пользователя папку «VirtualStore».