Funzione MddBootstrapInitialize2 (mddbootstrap.h)

Articolo
03/22/2025

Inizializza il processo chiamante per usare la versione del pacchetto framework di Windows App SDK che meglio corrisponde ai criteri specificati, con opzioni. Questa funzione è progettata per essere usata dalle app desktop in pacchetto con posizione esterna o senza pacchetti.

MddBootstrapInitialize2 offre miglioramenti all'usabilità e alla risoluzione dei problemi MddBootstrapInitialize.

Vedere anche costanti .

Sintassi

HRESULT MddBootstrapInitialize2(
  UINT32                        majorMinorVersion,
  PCWSTR                        versionTag,
  PACKAGE_VERSION               minVersion,
  MddBootstrapInitializeOptions options
);

Parametri

majorMinorVersion

Tipo: UINT32

La versione principale e secondaria di Windows App SDK prodotto da caricare (ad esempio, 1.2). Si tratta di un esatto versione principale e secondaria su cui trovare la corrispondenza; non un minimo.

majorMinorVersion viene codificato come 0xMMMMNNNN, dove M = Principale e N = Secondaria (ad esempio, la versione 1.2 viene codificata come 0x00010002).

versionTag

Tipo: PCWSTR

Tag di versione del pacchetto framework di Windows App SDK da caricare (se presente). Ad esempio: "prerelease".

minVersion

Tipo: PACKAGE_VERSION

Versione minima del pacchetto runtime di Windows App SDK (che corrisponde anche majorMinorVersion) da usare.

Questa versione (ad esempio, 0.319.455) è diversa dalla versione di Windows App SDK versione (ad esempio 1.0.2) e versione prodotto (ad esempio, 1.0).

I valori della versione del runtime di Windows App SDK possono essere ottenuti dall'intestazione C++ WindowsAppSDK-VersionInfo.h, vedere esempio per altri dettagli.

options

Tipo: MddBootstrapInitializeOptions

Opzioni per l'inizializzazione del programma di avvio automatico.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore.

Osservazioni:

Eventuali errori vengono registrati nel canale dell'applicazione di EventLog.

È possibile chiamare questa funzione più volte purché i parametri siano compatibili. La prima chiamata esegue il lavoro per risolvere un pacchetto di Framework; le chiamate successive sono un no-op a condizione che i parametri siano compatibili con Framework pacchetto risolto dalla prima chiamata. Se i parametri delle chiamate successive non sono compatibili, l'API ha esito negativo e restituisce un errore.

Questa funzione trova un pacchetto framework di Windows App SDK che soddisfa i criteri specificati e rende il pacchetto disponibile per l'uso da parte del processo corrente. Se più pacchetti soddisfano i criteri, questa funzione seleziona il candidato migliore.

Questa funzione deve essere chiamata all'avvio prima di chiamare qualsiasi altra API di Windows App SDK per assicurarsi che il componente del programma di avvio automatico possa inizializzare correttamente Windows App SDK e aggiungere il riferimento di runtime al pacchetto framework.

Questa funzione inizializza anche il DDLM (Dynamic Dependency Lifetime Manager). DDLM fornisce l'infrastruttura per impedire al sistema operativo di gestire il pacchetto framework di Windows App SDK mentre viene usato da un'app non in pacchetto.

Vedi anche Usare il runtime di Windows App SDK per le app in pacchetto con percorso esterno o unpackaged.

Nota

Prima di chiamare questa funzione, è necessario inizializzare COM per il thread corrente.

Nota

Se nelle opzioni di non si specifica MddBootstrapInitializeOptions::MddBootstrapInitializeOptions_OnPackageIdentity_NOOP, affinché questa API abbia esito positivo in un'app in pacchetto con percorso esterno o senza pacchetti, È necessario che i pacchetti di Windows App SDK siano installati nel dispositivo (vedere Tutorial: Use the bootstrapper API in an app packaged with external location or unpackaged that uses the Windows App SDK).

Esempio

#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");
}

#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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1809 (con Windows App SDK 1.0 o versione successiva)
intestazione	mddbootstrap.h
Biblioteca	Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL	Microsoft.WindowsAppRuntime.Bootstrap.dll

Condividi tramite