Partager via

Initialisation d’une application

  • Article

Pour activer la fonctionnalité d’installation, une application doit appeler un certain nombre de fonctions pendant son initialisation. Pour plus d’informations, consultez Mécanisme d’installation. Les étapes suivantes décrivent comment utiliser le programme d’installation pour initialiser une application :

Pour initialiser une application

  1. Appelez la fonction MsiGetProductCode pour que l’application puisse s’identifier dans le programme d’installation.

    Le code de produit est un paramètre obligatoire pour de nombreuses fonctions du programme d’installation.

  2. Appelez la fonction MsiGetUserInfo pour collecter les informations utilisateur la première fois que l’application démarre.

    Si l’appel à MsiGetUserInfo échoue, appelez la fonction MsiCollectUserInfo pour collecter les informations utilisateur.

  3. Affichez une interface utilisateur par défaut, si nécessaire, en appelant la fonction MsiSetInternalUI.

    Pour créer votre propre interface utilisateur, inscrivez-la dans le programme d’installation en appelant la fonction MsiSetExternalUI.

  4. Appelez la fonction MsiEnableLog pour définir le niveau de journalisation.

  5. Présentez à l’utilisateur les fonctionnalités disponibles en énumérant les fonctionnalités de votre application. Vous pouvez énumérer les fonctionnalités de la façon suivante :

    • Interroger le programme d’installation fonctionnalité par fonctionnalité. Par exemple, avant que l’application dessine un bouton ou un élément de menu, elle appelle la fonction MsiQueryFeatureState pour que le programme d’installation vérifie que la fonctionnalité est disponible.
    • Énumérez toutes les fonctionnalités disponibles en une fois en appelant la fonction MsiEnumFeatures. Pour utiliser cette fonction, l’application doit appeler MsiEnumFeatures à plusieurs reprises en incrémentant un index.

  6. Obtenez des informations détaillées sur l’installation actuelle en appelant les fonctions d’énumération suivantes à plusieurs reprises, en incrémentant une variable d’index pour chaque appel :

    • Appelez la fonction MsiEnumProducts pour énumérer les produits inscrits dans le programme d’installation.
    • Appelez la fonction MsiEnumComponents pour énumérer les composants.
    • Appelez la fonction MsiEnumComponentsQualifiers pour énumérer les qualificateurs de composant.
    • Appelez la fonction MsiEnumClients pour énumérer les produits d’un composant particulier.

    Si la valeur de retour d’une fonction d’énumération est ERROR_SUCCESS, il reste d’autres éléments à énumérer et la fonction doit être rappelée avec une variable d’index incrémentée. Si la valeur de retour est ERROR_NO_MORE_ITEMS, tous les éléments ont été énumérés et la fonction ne doit pas être rappelée.