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

Статья
03/22/2025

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

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

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

Синтаксис

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

Параметры

majorMinorVersion

Тип: UINT32

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

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

versionTag

Тип: PCWSTR

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

minVersion

Тип: PACKAGE_VERSION

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

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

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

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

Тип: HRESULT

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

Замечания

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

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

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

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

Эта функция также инициализирует диспетчера времени существования динамических зависимостей. DDLM предоставляет инфраструктуру, чтобы предотвратить обслуживание пакета пакета пакета ПАКЕТА SDK для приложений для Windows при использовании распакованным приложением.

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

Примечание.

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

Примечание.

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

Пример

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

Требования

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

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