Функция MddBootstrapInitialize (mddbootstrap.h)

  • Статья

Инициализирует вызывающий процесс для использования версии пакета платформы Windows App SDK, которая наилучшим образом соответствует указанным критериям. Эта функция предназначена для использования классическими приложениями, которые либо упаковываются с внешним расположением, либо не упаковываются.

MddBootstrapInitialize2 предлагает улучшения удобства использования и устранения неполадок по сравнению с MddBootstrapInitialize.

См. также статью Константы.

Синтаксис

HRESULT MddBootstrapInitialize(
  UINT32          majorMinorVersion,
  PCWSTR          versionTag,
  PACKAGE_VERSION minVersion
);

Параметры

majorMinorVersion

Тип: UINT32

Основная и дополнительная версии Windows App SDK продукта для загрузки (например, 1.2). Это точная основная и дополнительная версии для сопоставления; не минимум.

majorMinorVersion закодирован как 0xMMMMNNNN, где M = Основной и N = Дополнительный (например, версия 1.2 закодирована как 0x00010002).

versionTag

Тип: PCWSTR

Тег версии пакета платформы Windows App SDK для загрузки (при наличии). Например, "prerelease".

minVersion

Тип: PACKAGE_VERSION

Минимальная версия пакета среды выполнения Windows App SDK (которая также соответствует majorMinorVersion) для использования.

Эта версия (например, 0.319.455) отличается от версии выпуска Windows App SDK (например, 1.0.2) и версии продукта (например, 1.0).

Значения Windows App SDK версий среды выполнения можно получить из заголовка WindowsAppSDK-VersionInfo.hC++ . Дополнительные сведения см. в разделе Пример.

Возвращаемое значение

Тип: HRESULT

Если функция завершается успешно, она возвращает ERROR_SUCCESS. В противном случае функция возвращает код ошибки.

Комментарии

Все ошибки регистрируются в канале приложений EventLog.

Эту функцию можно вызывать несколько раз при условии совместимости параметров. Первый вызов выполняет работу по разрешению пакета Платформы ; последующие вызовы не выполняются при условии, что параметры совместимы с пакетом Платформы , разрешенным при первом вызове. Если параметры последующих вызовов несовместимы, API завершается сбоем и возвращает ошибку.

Эта функция находит пакет платформы Windows App SDK, соответствующий указанным критериям, и делает пакет доступным для использования текущим процессом. Если критерию соответствует несколько пакетов, эта функция выбирает наиболее подходящий вариант.

Эта функция должна вызываться при запуске перед вызовом любых других API-интерфейсов Windows App SDK, чтобы компонент начального загрузчика правильно инициализировал Windows App SDK и добавил ссылку среды выполнения в пакет платформы.

Эта функция также инициализирует диспетчер времени существования динамических зависимостей (DDLM). DDLM предоставляет инфраструктуру для предотвращения обслуживания операционной системой (ОС) пакета платформы Windows App SDK, пока он используется неупакованным приложением.

Также см. раздел Использование среды выполнения Windows App SDK для приложений, упакованных с внешним расположением или неупакованных.

Примечание

Com необходимо инициализировать для текущего потока перед вызовом этой функции.

Примечание

Для успешного выполнения этого API в неупакованном приложении необходимо, чтобы пакеты Windows App SDK были установлены на устройстве (см. раздел Предварительные требования статьи Руководство. Использование API начального загрузчика в приложении, упаковавшемся с внешним расположением или распакованом, в котором используется Windows App SDK).

Пример

См. пример в mddBootstrapInitialize2.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1809 (с Windows App SDK 1.0 или более поздней версии)
Верхняя часть mddbootstrap.h
Библиотека Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL Microsoft.WindowsAppRuntime.Bootstrap.dll

См. также раздел