Referenz zu Installer-Funktionen

Artikel
06/13/2023

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.