Partager via

MddBootstrapInitialize, fonction (mddbootstrap.h)

Initialise le processus d’appel pour utiliser la version du package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows qui correspond le mieux aux critères spécifiés. Cette fonction est destinée à être utilisée par les applications de bureau qui sont empaquetées avec un emplacement externe ou non empaquetées.

MddBootstrapInitialize2 offre une facilité d’utilisation et des améliorations de dépannage sur MddBootstrapInitialize.

Voir également les constantes.

Syntaxe

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

Paramètres

majorMinorVersion

Type : UINT32

Version principale et mineure du produit du Kit de développement logiciel (SDK) d’application Windows à charger (par exemple, 1.2). Il s’agit d’une version majeure et mineure exacte à mettre en correspondance ; pas un minimum.

majorMinorVersion est encodé en tant que 0xMMMMNNNN, où M = Major et N = Minor (par exemple, la version 1.2 est encodée en tant que 0x00010002).

versionTag

Type : PCWSTR

Balise de version du package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows à charger (le cas échéant). Par exemple : "prerelease".

minVersion

Type : PACKAGE_VERSION

Version minimale du package d’exécution du Kit de développement logiciel (SDK) d’application Windows (qui correspond également à majorMinorVersion) à utiliser.

Cette version (par exemple, 0.319.455) est différente de la version du KIT SDK d’application Windows (par exemple, 1.0.2) et de la version du produit (par exemple, 1.0).

Les valeurs de version du runtime du SDK d’application Windows peuvent être obtenues à partir de l’en-tête WindowsAppSDK-VersionInfo.hC++, voir Exemple pour plus d’informations.

Valeur de retour

Type : HRESULT

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur.

Remarques

Toutes les erreurs sont consignées dans le canal d’application d’EventLog.

Vous pouvez appeler cette fonction plusieurs fois à condition que les paramètres soient compatibles. Le premier appel effectue le travail de résolution d’un package Framework ; les appels suivants sont une no-op à condition que les paramètres soient compatibles avec le package Framework résolu par le premier appel. Si les paramètres des appels suivants ne sont pas compatibles, l’API échoue et retourne une erreur.

Cette fonction recherche un package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows qui répond aux critères spécifiés et rend le package disponible pour une utilisation par le processus actuel. Si plusieurs packages répondent aux critères, cette fonction sélectionne le meilleur candidat.

Cette fonction doit être appelée au démarrage avant d’appeler d’autres API du Kit de développement logiciel (SDK) d’application Windows pour vous assurer que le composant de programme d’amorçage peut initialiser correctement le SDK d’application Windows et ajouter la référence runtime au package d’infrastructure.

Cette fonction initialise également le Gestionnaire de durée de vie des dépendances dynamiques (DDLM). Le DDLM fournit une infrastructure pour empêcher le système d’exploitation de gérer le package d’infrastructure du SDK d’application Windows pendant qu’il est utilisé par une application non empaquetée.

Consultez également Utiliser le runtime du Kit de développement logiciel (SDK) d’application Windows pour les applications empaquetées avec un emplacement externe ou non empaquetées.

Note

COM doit être initialisé pour le thread actuel avant d’appeler cette fonction.

Note

Pour que cette API réussisse dans une application non empaquetée, il est nécessaire que les packages du Kit de développement logiciel (SDK) d’application Windows soient installés sur l’appareil (consultez la section Conditions préalables dans le tutoriel : Utiliser l’API de démarrage dans une application empaquetée avec un emplacement externe ou non empaquetée qui utilise le KIT DE DÉVELOPPEMENT LOGICIEL Windows App).

Example

Utilisation de 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);
}

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

Spécifications

Requirement Valeur
Client minimum requis Windows 10, version 1809 (avec windows App SDK 1.0 ou version ultérieure)
Header mddbootstrap.h
Library Microsoft.WindowsAppRuntime.Bootstrap.lib
DLL Microsoft.WindowsAppRuntime.Bootstrap.dll

Voir aussi

  • Last updated on