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

Windows 應用程式 SDK 運行時間套件的最低版本， (也符合要使用的majorMinorVersion) 。

例如，此版本 (0.319.455) 與 Windows 應用程式 SDK 版本 (不同，例如 1.0.2) 和產品版本 (例如 1.0) 。

Windows 應用程式 SDK 運行時間版本值可以從 C++ 標頭WindowsAppSDK-VersionInfo.h取得，如需詳細資訊，請參閱範例。

類型： HRESULT

如果函式成功，它會傳回 ERROR_SUCCESS。否則，函式會傳回錯誤碼。

任何錯誤都會記錄到 EventLog 的應用程式 通道。

您可以多次呼叫此函式，前提是參數相容。第一次呼叫會執行工作來解析 Framework 套件;後續呼叫是 no-op，前提是參數與第一次呼叫解析的 Framework 套件相容。如果後續呼叫的參數不相容，API 會失敗並傳回錯誤。

此函式會尋找符合指定準則的 Windows 應用程式 SDK 架構套件，並使套件可供目前進程使用。如果多個套件符合準則，此函式會選取最佳候選專案。

在啟動時必須呼叫此函式，才能呼叫任何其他 Windows 應用程式 SDK API，以確保啟動載入器元件可以正確地初始化 Windows 應用程式 SDK，並將運行時間參考新增至架構套件。

此函式也會初始化動態相依性存留期管理員 (DDLM) 。 DDLM 提供基礎結構，以防止操作系統 (操作系統) 在未封裝的應用程式使用時維護 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