Initialisieren einer Anwendung
Um die Installerfunktionalität zu aktivieren, muss eine Anwendung bei der Initialisierung eine Reihe von Funktionen aufrufen. Weitere Informationen finden Sie unter Installationsmechanismus. In den folgenden Schritten wird beschrieben, wie Sie das Installationsprogramm verwenden, um eine Anwendung zu initialisieren:
So initialisieren Sie eine Anwendung
Rufen Sie die MsiGetProductCode-Funktion auf, damit sich die Anwendung beim Installationsprogramm identifizieren kann.
Der Produktcode ist ein erforderlicher Parameter für viele Installerfunktionen.
Rufen Sie die MsiGetUserInfo-Funktion auf, um Benutzerinformationen zu sammeln, wenn die Anwendung zum ersten Mal gestartet wird.
Wenn der Aufruf von MsiGetUserInfo fehlschlägt, rufen Sie die MsiCollectUserInfo-Funktion auf, um Benutzerinformationen zu sammeln.
Zeigen Sie bei Bedarf eine Standard-Benutzeroberfläche an, indem Sie die MsiSetInternalUI-Funktion aufrufen.
Um Ihre eigene Benutzeroberfläche zu erstellen, registrieren Sie sie beim Installationsprogramm, indem Sie die MsiSetExternalUI-Funktion aufrufen.
Rufen Sie die MsiEnableLog-Funktion auf, um den Protokollierstand zu festlegen.
Stellen Sie dem Benutzer verfügbare Features zur Verfügung, indem Sie die Features Ihrer Anwendung aufzählen. Sie können Features wie folgt aufzählen:
- Fragen Sie das Installationsprogramm feature-by-feature ab. Bevor die Anwendung beispielsweise eine Schaltfläche oder ein Menüelement zeichnet, ruft die Anwendung die MsiQueryFeatureState-Funktion auf, damit das Installationsprogramm überprüfen kann, ob das Feature verfügbar ist.
- Aufzählen aller verfügbaren Features auf einmal durch Aufrufen der MsiEnumFeatures-Funktion. Um diese Funktion zu verwenden, muss die Anwendung MsiEnumFeatures wiederholt aufrufen, während ein Index erhöht wird.
Rufen Sie ausführliche Informationen zur aktuellen Installation ab, indem Sie die folgenden Enumerationsfunktionen wiederholt aufrufen und eine Indexvariable für jeden Aufruf erhöhen:
- Rufen Sie die MsiEnumProducts-Funktion auf, um produkte aufzählen, die beim Installationsprogramm registriert sind.
- Rufen Sie die MsiEnumComponents-Funktion auf, um Komponenten aufzählen.
- Rufen Sie die MsiEnumComponentQualifiers-Funktion auf, um Komponentenqualifizierer aufzählen.
- Rufen Sie die MsiEnumClients-Funktion auf, um die Produkte für eine bestimmte Komponente aufzählen.
Wenn der Rückgabewert für eine Enumerationsfunktion ERROR SUCCESS ist, müssen noch weitere Elemente aufgelistet werden, und die Funktion sollte mit einer inkrementierten Indexvariablen _ erneut aufgerufen werden. Wenn der Rückgabewert ERROR NO MORE ITEMS ist, wurden alle Elemente aufzählt, und die Funktion sollte _ _ nicht erneut aufgerufen _ werden.