Een toepassing initialiseren

Als u de functionaliteit van het installatieprogramma wilt inschakelen, moet een toepassing een aantal functies aanroepen wanneer deze wordt geïnitialiseerd. Zie Installatiemechanismevoor meer informatie. In de volgende stappen wordt beschreven hoe u het installatieprogramma gebruikt om een toepassing te initialiseren:

Een toepassing initialiseren

1. Roep de MsiGetProductCode--functie aan, zodat de toepassing zichzelf kan identificeren bij het installatieprogramma.

   De productcode is een vereiste parameter voor veel installatiefuncties.

2. Roep de MsiGetUserInfo- functie aan om gebruikersgegevens te verzamelen wanneer de toepassing voor het eerst wordt gestart.

   Als de aanroep naar MsiGetUserInfo mislukt, roept u de msiCollectUserInfo- functie aan om gebruikersgegevens te verzamelen.

3. Geef indien nodig een standaardgebruikersinterface weer door de MsiSetInternalUI- functie aan te roepen.

   Als u uw eigen gebruikersinterface wilt maken, registreert u deze bij het installatieprogramma door de MsiSetExternalUI--functie aan te roepen.

4. Roep de MsiEnableLog--functie aan om het logboekregistratieniveau in te stellen.

5. Presenteer de gebruiker met beschikbare functies door de functies van uw toepassing te inventariseren. U kunt functies op de volgende manieren opsommen:

   • Voer een query uit per functie van het installatieprogramma. Voordat de toepassing bijvoorbeeld een knop of een menu-item tekent, roept de toepassing de MsiQueryFeatureState functie aan, zodat het installatieprogramma kan controleren of de functie beschikbaar is.
   • Inventariseer alle beschikbare functies tegelijk door de functie MsiEnumFeatures aan te roepen. Als u deze functie wilt gebruiken, moet de toepassing MsiEnumFeatures herhaaldelijk aanroepen terwijl een index wordt verhoogd.

6. Krijg gedetailleerde informatie over de huidige installatie door de volgende opsommingsfuncties herhaaldelijk aan te roepen, waarbij een indexvariabele voor elke aanroep wordt verhoogd:

   • Roep de functie MsiEnumProducts aan om producten te inventariseren die zijn geregistreerd bij het installatieprogramma.
   • Roep de MsiEnumComponents- functie aan om onderdelen op te sommen.
   • Roep de MsiEnumComponentQualifiers functie aan om componentkwalificaties te inventariseren.
   • Roep de MsiEnumClients- functie aan om de producten voor een bepaald onderdeel op te sommen.

   Als de retourwaarde voor een opsommingsfunctie ERROR_SUCCESS is, moeten er nog meer items worden geïnventariseerd en moet de functie opnieuw worden aangeroepen met een incrementele indexvariabele. Als de retourwaarde is ERROR_NO_MORE_ITEMS, zijn alle items geïnventariseerd en mag de functie niet opnieuw worden aangeroepen.