Referenz zu Installer-Funktionen
Um Windows Installer in Ihrer Anwendung zu aktivieren, müssen Sie die Installer-Funktionen verwenden. Die Tabellen in diesem Thema identifizieren die Funktionen nach Kategorie.
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. |
Handleverwaltungsfunktionen
| Name | BESCHREIBUNG |
|---|---|
| MsiCloseHandle | Schließt ein geöffnetes Installationshandle. |
| MsiCloseAllHandles | Schließt alle geöffneten Installationshandles. Verwenden Sie dies nicht für die Bereinigung. |
Installations- und Konfigurationsfunktionen
| Name | BESCHREIBUNG |
|---|---|
| MsiAdvertiseProduct | Kündigt ein Produkt an. |
| MsiAdvertiseProductEx | Kündigt ein Produkt an. |
| MsiAdvertiseScript | Kopiert eine Ankündigungsskriptdatei an die angegebenen 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. Eine Produktbefehlszeile kann angegeben werden. |
| MsiReinstallProduct | Installiert eine Installation neu oder repariert sie. |
| MsiConfigureFeature | Konfiguriert den Installationszustand eines Produktfeatures. |
| 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 Ankündigungsskriptdatei an die angegebenen Speicherorte. |
| MsiSourceListAddSource | Fügt die Quellen eines Patches oder Produkts in einem angegebenen Kontext hinzu oder sortiert sie neu an. |
| MsiSourceListAddSourceEx | Fügt die Quellen eines Patches oder Produkts in einem angegebenen Kontext hinzu oder sortiert sie neu an. 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 einen Patch in einem angegebenen 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, die 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, die 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 einen Patch in einem bestimmten Kontext ab. |
| MsiSourceListSetInfo | Legt die zuletzt verwendete Quelle für ein Produkt oder einen 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 einen Patch oder ein 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. |
Komponentenspezifische 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 zu einer installierten Komponente über Benutzerkonten und Installationskontext hinweg zurück.
Windows Installer 4.5 und früher: Nicht unterstützt. |
| MsiLocateComponent | Gibt den vollständigen Pfad zu einer installierten Komponente ohne Produktcode zurück. |
| MsiQueryComponentState | Gibt den Installationszustand 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. |
Reine Anwendungsfunktionen
| Name | BESCHREIBUNG |
|---|---|
| MsiCollectUserInfo | Speichert Benutzerinformationen aus einem Installations-Assistenten. |
| MsiUseFeature | Erhöht die Nutzungsanzahl für ein Feature und gibt den Installationszustand an. |
| MsiUseFeatureEx | Erhöht die Nutzungsanzahl für ein Feature und gibt den Installationszustand 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 angegebenen 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 hinweg auf.
Windows Installer 4.5 und früher: Nicht unterstützt. |
| MsiEnumClients | Listet die Clients einer installierten Komponente auf. |
| MsiEnumClientsEx | Listet die Clients einer installierten Komponenten über Benutzerkonten und Installationskontext hinweg auf.
Windows Installer 4.5 und früher: Nicht unterstützt. |
| MsiEnumComponentQualifiers | Listet die angekündigten Qualifizierer für eine Komponente auf. |
| MsiQueryFeatureState | Gibt den Installationszustand für ein Feature zurück. |
| MsiQueryFeatureStateEx | Gibt den Installationszustand für ein Produktfeature 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. |
| MsiQueryProductState | Gibt den Installationszustand 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 für die Verwendung mit den Funktionen, die auf die Datenbank zugreifen. |
| MsiOpenPackage | Öffnet ein Paket für die Verwendung mit den Funktionen, die auf die Datenbank zugreifen. |
| MsiOpenPackageEx | Öffnet ein Paket für die Verwendung mit den 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 | Untersucht 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 eine angegebene Datei ein Installationspaket ist. |
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, sowie eine Liste der Transformationen von 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 einen oder mehrere Patches 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 werden. Verfügbar in Windows Installer 3.0. |
| MsiGetPatchFileList | Wenn eine Liste der MSP-Dateien bereitgestellt wird, ruft diese Funktion die Liste der Dateien ab, die von den Patches für das Ziel aktualisiert werden können. Verfügbar in Windows Installer 4.0. |
| MsiGetPatchInfoEx | Abfragen nach Informationen zur Anwendung eines angegebenen Patches für ein angegebenes Produkt. 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 | Übernimmt 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 Signaturgeberzertifikat und den Hash der Datei zurück. |
| MsiGetFileVersion | Gibt die Versions- 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 vornimmt. Diese Funktion ist ab Windows Installer 4.5 verfügbar. |
| MsiEndTransaction | Commit oder Rollback aller Installationen, die zur Transaktion gehören. Diese Funktion ist ab Windows Installer 4.5 verfügbar. |
Datenbankfunktionen
Zusätzlich zu den Windows Installer-Funktionen, die in den vorherigen Tabellen identifiziert wurden, können Sie Informationen in der Installationsdatenbank mithilfe der Datenbankzugriffsfunktionen bearbeiten, die im Abschnitt Datenbankfunktionen beschrieben werden.
Installationsstrukturen
Darüber hinaus werden einige Informationen in der Installationsdatenbank mithilfe der im Abschnitt Installationsstrukturen beschriebenen Strukturen verarbeitet.