Installer-Funktionsreferenz
Um Windows Installer in Ihrer Anwendung zu aktivieren, müssen Sie die Installationsprogrammfunktionen verwenden. In den Tabellen in diesem Thema werden die Funktionen nach Kategorie identifiziert.
Benutzeroberfläche und Protokollierungsfunktionen
| Name | Beschreibung |
|---|---|
| MsiSetInternalUI- | Aktiviert die interne Benutzeroberfläche des Installers. |
| MsiSetExternalUI- | Aktiviert einen externen Benutzeroberflächenhandler, der Nachrichten in einem Zeichenfolgenformat empfängt. |
| MsiSetExternalUIRecord- | Aktiviert einen externen Benutzeroberflächenhandler, der Nachrichten in einem Datensatzformat empfängt. |
| MsiEnableLog- | Legt den Protokollmodus für alle Installationen im aufrufenden Prozess fest. |
Behandeln von Verwaltungsfunktionen
| Name | Beschreibung |
|---|---|
| MsiCloseHandle- | Schließt ein geöffnetes Installationshandle. |
| MsiCloseAllHandles | Schließt alle geöffneten Installationshandles. Verwenden Sie nicht zum Bereinigen. |
Installations- und Konfigurationsfunktionen
| Name | Beschreibung |
|---|---|
| MsiAdvertiseProduct- | Kündigt ein Produkt an. |
| MsiAdvertiseProductEx- | Kündigt ein Produkt an. |
| MsiAdvertiseScript- | Kopiert eine angekündigte Skriptdatei an bestimmte Speicherorte. |
| MsiInstallProduct- | Installiert oder entfernt eine Anwendung oder Anwendungssuite. |
| MsiConfigureProduct- | Installiert oder entfernt eine Anwendung oder Anwendungssuite. |
| MsiConfigureProductEx- | Installiert oder entfernt eine Anwendung oder Anwendungssuite. Es kann eine Produktbefehlszeile angegeben werden. |
| MsiReinstallProduct- | Installiert eine Installation neu oder repariert sie. |
| MsiConfigureFeature- | Konfiguriert den Installationsstatus eines Features. |
| MsiReinstallFeature- | Überprüft oder repariert Features. |
| MsiInstallMissingComponent- | Installiert fehlende Komponenten. |
| MsiInstallMissingFile- | Installiert fehlende Dateien. |
| MsiNotifySidChange | Benachrichtigt und aktualisiert die internen Windows Installer-Informationen mit Änderungen an Benutzer-SIDs. Verfügbar ab Windows Installer 3.1. |
| MsiProcessAdvertiseScript- | Verarbeitet eine angekündigte Skriptdatei an angegebenen Speicherorten. |
| MsiSourceListAddSource- | Fügt die Quellen eines Patches oder Produkts in einem bestimmten Kontext hinzu oder neu. |
| MsiSourceListAddSourceEx- | Fügt die Quellen eines Patches oder Produkts in einem bestimmten Kontext hinzu oder neu. Erstellt eine Quellliste für einen Patch, der in einem angegebenen Kontext nicht vorhanden ist. Verfügbar in Windows Installer 3.0. |
| MsiSourceListClearSource- | Entfernt eine vorhandene Quelle für ein Produkt oder Patch in einem bestimmten Kontext. Verfügbar in Windows Installer 3.0. |
| MsiSourceListClearAll- | Entfernt alle vorhandenen Quellen eines bestimmten Quelltyps für eine angegebene Produktinstanz. |
| MsiSourceListClearAllEx- | Entfernt alle vorhandenen Quellen eines bestimmten Quelltyps für eine angegebene Produktinstanz. Verfügbar in Windows Installer 3.0. |
| MsiSourceListForceResolution- | Entfernt die Registrierung der aktuellen Quelle des Produkts oder Patches, das als Eigenschaft "LastUsedSource" registriert ist. Diese Funktion wirkt sich nicht auf die registrierte Quellliste aus. |
| MsiSourceListForceResolutionEx- | Entfernt die Registrierung der aktuellen Quelle des Produkts oder Patches, das als Eigenschaft "LastUsedSource" registriert ist. Diese Funktion wirkt sich nicht auf die registrierte Quellliste aus. Verfügbar in Windows Installer 3.0. |
| MsiSourceListGetInfo- | Ruft Informationen zur Quellliste für ein Produkt oder Patch in einem bestimmten Kontext ab. |
| MsiSourceListSetInfo- | Legt die zuletzt verwendete Quelle für ein Produkt oder Patch in einem angegebenen Kontext fest. Verfügbar in Windows Installer 3.0. |
| MsiSourceListEnumMediaDisks | Listet die Liste der Datenträger auf, die für die Medienquelle für ein Patch oder Produkt registriert sind. Verfügbar in Windows Installer 3.0. |
| MsiSourceListAddMediaDisk | Fügt einen Datenträger der Medienquelle eines registrierten Produkts oder Patches hinzu oder aktualisiert sie. Verfügbar in Windows Installer 3.0. |
| MsiSourceListClearMediaDisk | Entfernt einen vorhandenen registrierten Datenträger unter der Medienquelle für ein Produkt oder Patch in einem bestimmten Kontext. Verfügbar in Windows Installer 3.0. |
| MsiSourceListEnumSources- | Listet die Quellen in der Quellliste eines angegebenen Patches oder Produkts auf. Verfügbar in Windows Installer 3.0. |
Component-Specific-Funktionen
| Name | Beschreibung |
|---|---|
| MsiProvideAssembly | Installiert und gibt den vollständigen Komponentenpfad für eine Assembly zurück. |
| MsiProvideComponent- | Installiert und gibt den vollständigen Komponentenpfad einer Komponente zurück. |
| MsiProvideQualifiedComponent | Installiert und gibt den vollständigen Komponentenpfad einer qualifizierten Komponente zurück. |
| MsiProvideQualifiedComponentEx | Installiert und gibt den vollständigen Komponentenpfad einer qualifizierten Komponente zurück, die von einem Produkt veröffentlicht wird. |
| MsiGetComponentPath- | Gibt den vollständigen Pfad oder Registrierungsschlüssel zu einer installierten Komponente zurück. |
| MsiGetComponentPathEx- | Gibt den vollständigen Pfad oder Registrierungsschlüssel für eine installierte Komponente für Benutzerkonten und Installationskontext zurück.
Windows Installer 4.5 und frühere: Nicht unterstützt. |
| MsiLocateComponent- | Gibt den vollständigen Pfad zu einer installierten Komponente ohne Produktcode zurück. |
| MsiQueryComponentState- | Gibt den installationsstatus für eine Komponente zurück. Kann Komponenten einer Instanz eines Produkts abfragen, das unter anderen Benutzerkonten als dem aktuellen Benutzer installiert ist. Verfügbar in Windows Installer 3.0 oder höher. |
Application-Only-Funktionen
| Name | Beschreibung |
|---|---|
| MsiCollectUserInfo- | Speichert Benutzerinformationen aus einem Installations-Assistenten. |
| MsiUseFeature- | Erhöht die Anzahl der Verwendungen für ein Feature und gibt den Installationsstatus an. |
| MsiUseFeatureEx- | Erhöht die Anzahl der Verwendungen für ein Feature und gibt den Installationsstatus an. |
| MsiGetProductCode- | Gibt den Produktcode mithilfe des Komponentencodes zurück. |
Systemstatusfunktionen
| Name | Beschreibung |
|---|---|
| MsiEnumProducts- | Listet beworbene Produkte auf. |
| MsiEnumProductsEx- | Listet alle Instanzen von angekündigten oder installierten Produkten in einem bestimmten Kontext auf. Verfügbar in Windows Installer 3.0 oder höher. |
| MsiEnumRelatedProducts- | Listet derzeit installierte Produkte mit einem angegebenen Upgradecode auf. |
| MsiEnumFeatures- | Listet veröffentlichte Features auf. |
| MsiEnumComponents- | Listet die installierten Komponenten auf. |
| MsiEnumComponentsEx | Listet die installierten Komponenten über Benutzerkonten und Installationskontext auf.
Windows Installer 4.5 und frühere: Nicht unterstützt. |
| MsiEnumClients- | Listet die Clients einer installierten Komponente auf. |
| MsiEnumClientsEx- | Listet die Clients einer installierten Komponente über Benutzerkonten und Installationskontext auf.
Windows Installer 4.5 und frühere: Nicht unterstützt. |
| MsiEnumComponentQualifiers | Listet die angekündigten Qualifizierer für eine Komponente auf. |
| MsiQueryFeatureState- | Gibt den Installationsstatus eines Features zurück. |
| MsiQueryFeatureStateEx- | Gibt den Installationsstatus für ein Produktfeature zurück. Kann Features einer Instanz eines Produkts abfragen, das unter anderen Benutzerkonten als dem aktuellen Benutzer installiert ist. Verfügbar in Windows Installer 3.0 oder höher. |
| MsiQueryProductState- | Gibt den installationsstatus für eine Anwendung oder Anwendungssuite zurück. |
| MsiGetFeatureUsage- | Gibt Nutzungsmetriken für ein Feature zurück. |
| MsiGetProductInfo- | Gibt Produktinformationen für veröffentlichte und installierte Produkte zurück. |
| MsiGetProductInfoEx- | Gibt Produktinformationen für angekündigte und installierte Produkte zurück. Kann Informationen zu einer Instanz eines Produkts abrufen, das unter einem anderen Benutzerkonto als dem aktuellen Benutzer installiert ist. Verfügbar in Windows Installer 3.0 oder höher. |
| MsiGetUserInfo- | Gibt registrierte Benutzerinformationen für ein installiertes Produkt zurück. |
Produktabfragefunktionen
| Name | Beschreibung |
|---|---|
| MsiOpenProduct- | Öffnet ein Produkt zur Verwendung mit den Funktionen, die auf die Datenbank zugreifen. |
| MsiOpenPackage- | Öffnet ein Paket für die Funktionen, die auf die Datenbank zugreifen. |
| MsiOpenPackageEx- | Öffnet ein Paket für die Funktionen, die auf die Datenbank zugreifen. |
| MsiIsProductElevated | Überprüft, ob das Produkt mit erhöhten Rechten installiert ist. |
| MsiGetProductInfoFromScript- | Gibt Produktinformationen für eine Installationsskriptdatei zurück. |
| MsiGetProductProperty- | Ruft Eigenschaften in der Produktdatenbank ab. |
| MsiGetShortcutTarget- | Überprüft eine Verknüpfung und gibt das Produkt, den Featurenamen und die Komponente zurück, falls verfügbar. |
| MsiGetFeatureInfo- | Gibt beschreibende Informationen für ein Feature zurück. |
| MsiVerifyPackage- | Überprüft, ob es sich bei einer angegebenen Datei um ein Installationspaket handelt. |
Patchfunktionen
| Name | Beschreibung |
|---|---|
| MsiApplyPatch- | Ruft eine Installation auf und wendet ein Patchpaket an. |
| MsiEnumPatches- | Gibt die GUID für jeden Patch zurück, der auf ein Produkt angewendet wird, und eine Liste der Transformationen aus jedem Patch, der für das Produkt gilt. |
| MsiGetPatchInfo- | Gibt Informationen zu einem Patch zurück. |
| MsiRemovePatches | Deinstalliert einen Patch von einem Produkt. Verfügbar in Windows Installer 3.0. |
| MsiDeterminePatchSequence- | Bestimmt die beste Anwendungssequenz für eine Reihe von Patches und Produkten. Verfügbar in Windows Installer 3.0. |
| MsiApplyMultiplePatches | Wendet mindestens ein Patche auf Produkte an. Verfügbar in Windows Installer 3.0. |
| MsiEnumPatchesEx- | Listet alle Patches auf, die für ein Produkt in einem bestimmten Kontext oder in allen Kontexten angewendet wurden. Verfügbar in Windows Installer 3.0. |
| MsiGetPatchFileList- | Wenn eine Liste von MSP-Dateien bereitgestellt wird, ruft diese Funktion die Liste der Dateien ab, die von den Patches für die Targe aktualisiert werden können. Verfügbar in Windows Installer 4.0. |
| MsiGetPatchInfoEx- | Fragt nach Informationen zur Anwendung eines angegebenen Patches auf ein angegebenes Produkt ab. Verfügbar in Windows Installer 3.0. |
| MsiExtractPatchXMLData- | Extrahiert Informationen aus einem Patch. Verfügbar in Windows Installer 3.0. |
| MsiDetermineApplicablePatches | Bestimmt den besten Satz von Patches, die zum Aktualisieren eines Produkts oder einer Gruppe von Produkten erforderlich sind. Verfügbar in Windows Installer 3.0. |
Dateiabfragefunktionen
| Name | Beschreibung |
|---|---|
| MsiGetFileHash- | Verwendet den Pfad zu einer Datei und gibt einen 128-Bit-Hash dieser Datei zurück. |
| MsiGetFileSignatureInformation | Verwendet den Pfad zu einer Datei, die digital signiert wurde, und gibt das Signiererzertifikat und den Hash der Datei zurück. |
| MsiGetFileVersion- | Gibt die Versionszeichenfolge und die Sprachzeichenfolge zurück. |
Transaktionsverwaltungsfunktionen
| Name | Beschreibung |
|---|---|
| MsiBeginTransaction- | Startet die Transaktionsverarbeitung einer Installation mit mehreren Paketen und gibt einen Bezeichner für die Transaktion zurück. Diese Funktion ist ab Windows Installer 4.5 verfügbar. |
| MsiJoinTransaction- | Fordert an, dass der Windows Installer den aktuellen Prozess zum Besitzer der Transaktion macht, die eine Installation mit mehreren Paketen installiert. Diese Funktion ist ab Windows Installer 4.5 verfügbar. |
| MsiEndTransaction- | Führt einen Commit durch oder führt einen Rollback aller Installationen durch, die zur Transaktion gehören. Diese Funktion ist ab Windows Installer 4.5 verfügbar. |
Datenbankfunktionen
Zusätzlich zu den in den vorherigen Tabellen identifizierten Windows Installer-Funktionen können Sie Informationen in der Installationsdatenbank mithilfe der Datenbankzugriffsfunktionen bearbeiten, die im Abschnitt Datenbankfunktionen beschrieben werden.
Installer-Strukturen
Darüber hinaus werden einige Informationen in der Installationsdatenbank mithilfe der im Abschnitt Installationsstrukturen beschriebenen Strukturen behandelt.