MddBootstrapInitialize-Funktion (mddbootstrap.h)

Artikel
09/08/2023

Initialisiert den aufrufenden Prozess, um die Version des Windows App SDK Frameworkpakets zu verwenden, die den angegebenen Kriterien am besten entspricht. Diese Funktion soll von Desktop-Apps verwendet werden, die entweder mit einem externen Speicherort gepackt oder entpackt sind.

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

Siehe auch Konstanten.

Syntax

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

Parameter

majorMinorVersion

Typ: UINT32

Die Haupt- und Nebenversion des Windows App SDK zu ladenden Produkt (z. B. 1.2). Dies ist eine genaue Haupt- und Nebenversion, die übereinstimmen. nicht mindestens.

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

versionTag

Typ: PCWSTR

Das Versionstag des zu ladenden Windows App SDK Frameworkpakets (falls vorhanden). Beispiel: "prerelease".

minVersion

Typ: PACKAGE_VERSION

Die Mindestversion des zu verwendenden Windows App SDK Runtimepakets (das auch mit majorMinorVersion übereinstimmt).

Diese Version (z. B. 0.319.455) unterscheidet sich von der Windows App SDK Releaseversion (z. B. 1.0.2) und der Produktversion (z. B. 1.0).

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

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück.

Hinweise

Alle Fehler werden im Anwendungskanal von EventLog protokolliert.

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

Diese Funktion sucht nach einem Windows App SDK Frameworkpaket, das die angegebenen Kriterien erfüllt und das Paket zur Verwendung durch den aktuellen Prozess zur Verfügung stellt. Wenn mehrere Pakete die Kriterien erfüllen, 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 die 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 stellt eine Infrastruktur bereit, die verhindert, dass das Betriebssystem das Windows App SDK Frameworkpaket verwaltet, während es von einer nicht gepackten App verwendet wird.

Weitere Informationen finden Sie unter Verwenden der Windows App SDK Runtime für Apps, die mit einem externen Speicherort verpackt oder entpackt sind.

Hinweis

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

Hinweis

Damit diese API in einer nicht gepackten App erfolgreich ist, ist es erforderlich, dass die Windows App SDK Pakete auf dem Gerät installiert werden (siehe Abschnitt Voraussetzungen unter Tutorial: Verwenden der Bootstrapper-API in einer App, die mit einem externen Speicherort verpackt oder entpackt ist, die die Windows App SDK verwendet).

Beispiel

Sehen Sie sich das Beispiel in MddBootstrapInitialize2 an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	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

Freigeben über