Freigeben über

MddBootstrapInitialize-Funktion (mddbootstrap.h)

Initialisiert den Aufrufprozess, um die Version des Windows App SDK-Frameworkpakets zu verwenden, das den angegebenen Kriterien am besten entspricht. Diese Funktion soll von Desktop-Apps verwendet werden, die entweder an einen externen Speicherort verpackt oder entpackt werden.

MddBootstrapInitialize2 bietet Verbesserungen bei der Benutzerfreundlichkeit und Problembehandlung gegenüber MddBootstrapInitialize.

Siehe auch Konstanten.

Syntax

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

Die Parameter

majorMinorVersion

Typ: UINT32-

Die Haupt- und Nebenversion des Windows App SDK Produkt geladen werden (z. B. 1.2). Dies ist eine genau Haupt- und Nebenversion, die übereinstimmen soll; nicht mindestens.

majorMinorVersion- wird als 0xMMMMNNNNcodiert, wobei M = Major und N = Minor (z. B. Version 1.2 als 0x00010002codiert ist).

versionTag

Typ: PCWSTR-

Die Versionskennzeichnung des Windows App SDK-Frameworkpakets, das geladen werden soll (falls vorhanden). Beispiel: "prerelease".

minVersion

Typ: PACKAGE_VERSION

Die Mindestversion des Windows App SDK Laufzeitpakets (das auch mit majorMinorVersionübereinstimmt), das verwendet werden soll.

Diese Version (z. B. 0.319.455) unterscheidet sich vom Windows App SDK Version Version (z. B. 1.0.2) und Produkt- Version (z. B. 1.0).

Die Werte der Windows App SDK-Laufzeitversion können aus dem C++-Header WindowsAppSDK-VersionInfo.habgerufen werden. Weitere Informationen finden Sie unter Beispiel-.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich verläuft, wird ERROR_SUCCESSzurückgegeben. Andernfalls gibt die Funktion einen Fehlercode zurück.

Bemerkungen

Alle Fehler werden im Application-Kanal des EventLog protokolliert.

Sie können diese Funktion mehrmals aufrufen, vorausgesetzt, die Parameter sind kompatibel. Der erste Aufruf führt die Arbeit aus, um ein Framework--Paket aufzulösen; Nachfolgende Aufrufe sind eine no-op vorausgesetzt, dass die Parameter mit dem Framework Paket kompatibel sind, das durch den ersten Aufruf aufgelöst wurde. Wenn die Parameter der nachfolgenden Aufrufe nicht kompatibel sind, schlägt die API fehl und gibt einen Fehler zurück.

Diese Funktion findet ein Windows App SDK-Frameworkpaket, das den angegebenen Kriterien entspricht, und stellt das Paket zur Verwendung durch den aktuellen Prozess zur Verfügung. Wenn mehrere Pakete den Kriterien entsprechen, wählt diese Funktion den besten Kandidaten aus.

Diese Funktion muss beim Start aufgerufen werden, bevor andere Windows App SDK-APIs aufgerufen werden, um sicherzustellen, dass die Bootstrapperkomponente das Windows App SDK ordnungsgemäß initialisieren und den Laufzeitverweis zum Frameworkpaket hinzufügen kann.

Diese Funktion initialisiert auch den Dynamic Dependency Lifetime Manager (DDLM). Das DDLM bietet Infrastruktur, um zu verhindern, dass das Betriebssystem das Windows App SDK-Frameworkpaket gewartet, während es von einer entpackten App verwendet wird.

Siehe auch Verwenden der Windows App SDK-Runtime für Apps, die mit externem Speicherort verpackt sind, oder entpackte.

Hinweis

COM muss für den aktuellen Thread initialisiert werden, bevor Sie diese Funktion aufrufen.

Hinweis

Damit diese API in einer entpackten App erfolgreich ist, müssen die Windows App SDK-Pakete auf dem Gerät installiert werden (siehe Abschnitt "Voraussetzungen" in Lernprogramm: Verwenden der Bootstrapper-API in einer App, die mit externem Speicherort verpackt ist oder entpackt wird, das das Windows App SDKverwendet).

Beispiel

Verwenden von C:

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

HRESULT hr = MddBootstrapInitialize(
    WINDOWSAPPSDK_RELEASE_MAJORMINOR,
    WINDOWSAPPSDK_RELEASE_VERSION_TAG_W,
    { WINDOWSAPPSDK_RUNTIME_VERSION_UINT64 }
);

if (FAILED(hr))
{
    wprintf(L"Error 0x%X in Bootstrap initialization\n", hr);
}

Verwenden von C++:

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

if (FAILED(MddBootstrapInitialize(
    Microsoft::WindowsAppSDK::Release::MajorMinor,
    Microsoft::WindowsAppSDK::Release::VersionTag, 
    { Microsoft::WindowsAppSDK::Runtime::UInt64 }))) 
{
    throw std::exception("Error in Bootstrap initialization");
}

Anforderungen

Anforderung Wert
Unterstützter Client (Mindestversion) Windows 10, Version 1809 (mit Windows App SDK 1.0 oder höher)
Kopfzeile mddbootstrap.h
Bibliothek Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL Microsoft.WindowsAppRuntime.Bootstrap.dll

Siehe auch

  • Last updated on