通过

MddBootstrapInitialize 函数 （mddbootstrap.h）

  • 项目

初始化调用过程，以使用最符合指定条件的 Windows 应用 SDK 框架包的版本。 此函数旨在供打包到外部位置或未打包的桌面应用使用。

mddBootstrapInitialize2 提供可用性和故障排除改进，mddBootstrapInitialize。

另请参阅 常量。

语法

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

参数

majorMinorVersion

类型：UINT32

Windows 应用 SDK 的主要版本和次要版本 要加载的产品（例如 1.2）。 这是 主要版本和次要版本进行匹配;不是最小值。

majorMinorVersion 编码为 0xMMMMNNNN，其中 M = Major 和 N = Minor（例如，版本 1.2 编码为 0x00010002）。

versionTag

类型：PCWSTR

要加载的 Windows 应用 SDK 框架包的版本标记（如果有）。 例如，"prerelease"。

minVersion

类型：PACKAGE_VERSION

要使用的 Windows 应用 SDK 运行时 包（也与 majorMinorVersion匹配）的最低版本。

此版本（例如，0.319.455）不同于 Windows 应用 SDK 版本 版本（例如 1.0.2）和 产品 版本（例如 1.0）。

可以从C++标头 WindowsAppSDK-VersionInfo.h获取 Windows 应用 SDK 运行时版本值，有关详细信息，请参阅 示例。

返回值

类型：HRESULT

如果函数成功，则返回 ERROR_SUCCESS。 否则，该函数将返回错误代码。

注解

任何错误都会记录到 EventLog 的 应用程序 通道。

如果参数兼容，可以多次调用此函数。 第一次调用执行解析 Framework 包的工作;后续调用是一个 no-op，前提是参数与第一次调用解析的 Framework 包兼容。 如果后续调用的参数不兼容，API 将失败并返回错误。

此函数查找符合指定条件的 Windows 应用 SDK 框架包，并使该包可供当前进程使用。 如果多个包满足条件，此函数将选择最佳候选项。

必须先在启动时调用此函数，然后才能调用任何其他 Windows 应用 SDK API，以确保引导程序组件能够正确初始化 Windows 应用 SDK 并添加对框架包的运行时引用。

此函数还初始化 动态依赖项生存期管理器（DDLM）。 DDLM 提供基础结构，以防止作系统（OS）在未打包的应用使用 Windows 应用 SDK 框架包时提供服务。

另请参阅 将 Windows 应用 SDK 运行时用于打包到外部位置或未打包的应用。

注释

调用此函数之前，必须为当前线程初始化 COM。

注释

若要使此 API 在未打包的应用中成功，必须在设备上安装 Windows 应用 SDK 包（请参阅 教程中的先决条件部分：在打包到外部位置的应用中使用引导程序 API，或使用 Windows 应用 SDK解压缩）。

示例

请参阅 MddBootstrapInitialize2中的示例。

要求

要求 价值
最低支持的客户端 Windows 10 版本 1809（使用 Windows 应用 SDK 1.0 或更高版本）
标头 mddbootstrap.h
图书馆 Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL Microsoft.WindowsAppRuntime.Bootstrap.dll

另请参阅