Freigeben über


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.