Installer-Objekt

Zunächst muss ein Installer-Objekt erstellt werden, um die Automatisierungsunterstützung zu laden, die für COM erforderlich ist, um auf die Installationsprogrammfunktionen zuzugreifen. Dieses Objekt stellt Wrapper bereit, um die Objekte der obersten Ebene zu erstellen und auf ihre Methoden zuzugreifen.

Sie können das Installer-Objekt aus der ProgId "WindowsInstaller.Installer" erstellen.

Members

Das Installer-Objekt verfügt über diese Typen von Membern:

Methoden

Das Installer-Objekt verfügt über diese Methoden.

Methode Beschreibung
AddSource Fügt der Liste gültiger Netzwerkquellen in der Quellliste eine Quelle hinzu.
AdvertiseProduct Kündigt ein Installationspaket an.
AdvertiseScript Kündigt ein Installationspaket an.
ApplyMultiplePatches Wendet ein oder mehrere Patches auf Produkte an, die für den Patch berechtigt sind. Legt die PATCH-Eigenschaft auf den Pfad der bereitgestellten Patchpakete fest.
ApplyPatch Ruft eine Installation auf und legt die PATCH-Eigenschaft auf den Pfad des Patchpakets für jedes Produkt fest, das vom Patchpaket als für den Empfang des Patches berechtigt aufgeführt wird.
ClearSourceList Entfernt alle Netzwerkquellen aus der Quellliste.
CollectUserInfo Ruft eine Benutzeroberflächen-Assistentensequenz auf, die sowohl Benutzerinformationen als auch den Produktcode sammelt und speichert.
ConfigureFeature Konfiguriert den installierten Zustand eines Produktfeatures.
ConfigureProduct Installiert oder deinstalliert ein Produkt.
CreateAdvertiseScript Generiert ein Ankündigen eines Skripts.
CreateRecord Gibt ein neues Record-Objekt mit der angeforderten Anzahl von Feldern zurück.
EnableLog Aktiviert die Protokollierung des ausgewählten Nachrichtentyps für alle nachfolgenden Installationssitzungen im aktuellen Prozessbereich.
ExtractPatchXMLData Extrahiert Informationen aus einem Patch als XML-Zeichenfolge.
Dateihash Nimmt den Pfad zu einer Datei und gibt einen 128-Bit-Hash dieser Datei zurück.
FileSignatureInfo Nimmt den Pfad zu einer Datei und gibt ein SAFEARRAY von Bytes zurück, das den Hash oder das codierte Zertifikat darstellt.
FileSize Gibt die Größe der angegebenen Datei zurück.
FileVersion Gibt die Versionszeichenfolge oder Sprachzeichenfolge des angegebenen Pfads zurück.
ForceSourceListResolution Erzwingt, dass das Installationsprogramm die Quellliste nach einer gültigen Produktquelle durchsucht, wenn das nächste Mal eine Quelle erforderlich ist.
InstallProduct Öffnet ein Installationspaket und initialisiert eine Installationssitzung.
LastErrorRecord Gibt ein Record-Objekt zurück, das Fehlerparameter für den letzten Fehler der Funktion enthält, die den Fehlerdatensatz erzeugt hat.
OpenDatabase Öffnet eine vorhandene Datenbank oder erstellt eine neue.
OpenPackage Öffnet ein Installationspaket für die Verwendung mit Funktionen, die auf die Produktdatenbank zugreifen und die Engine installieren.
OpenProduct Öffnet ein Installationspaket für ein installiertes Produkt unter Verwendung des Produktcodes.
Provideassembly Gibt den installierten Pfad einer Assembly zurück.
ProvideComponent Gibt den vollständigen Komponentenpfad zurück und führt alle erforderlichen Installationen aus.
ProvideQualifiedComponent Gibt den vollständigen Komponentenpfad zurück und führt alle erforderlichen Installationen aus.
RegistryValue Liest Informationen zu einem angegebenen Registrierungsschlüssel des Werts.
ReinstallFeature Installiert Features neu oder korrigiert Probleme mit installierten Features.
ReinstallProduct Installiert ein Produkt neu oder korrigiert Installationsprobleme in einem installierten Produkt.
RemovePatches Entfernt ein oder mehrere Patches für Produkte, die für den Patch berechtigt sind.
UseFeature Erhöht die Nutzungsanzahl für ein bestimmtes Feature und gibt den Installationsstatus für dieses Feature zurück.

Eigenschaften

Das Installer-Objekt verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp Beschreibung
ClientsEx
Gibt ein RecordList-Objekt zurück, das Produkte auflistet, die eine angegebene installierte Komponente verwenden.
Windows Installer 4.5 und früher: Wird nicht unterstützt.
ComponentClients
Gibt ein StringList-Objekt zurück, das den Satz von Clients einer angegebenen Komponente auflistet.
ComponentPath
Gibt den vollständigen Pfad zu einer installierten Komponente zurück.
ComponentPathEx
Gibt ein RecordList-Objekt zurück, das den vollständigen Pfad einer angegebenen installierten Komponente angibt.
Windows Installer 4.5 und früher: Wird nicht unterstützt.
ComponentQualifiers
Gibt ein StringList-Objekt zurück, das den Satz registrierter Qualifizierer für die angegebene Komponente auflistet.
Komponenten
Gibt ein StringList-Objekt zurück, das den Satz installierter Komponenten für alle Produkte auflistet.
ComponentsEx
Gibt ein RecordList-Objekt zurück, das installierte Komponenten auflistet.
Windows Installer 4.5 und früher: Wird nicht unterstützt.
Umgebung
Lesen/Schreiben
Der Zeichenfolgenwert für eine Umgebungsvariable des aktuellen Prozesses.
FeatureParent
Gibt das übergeordnete Feature eines Features an.
Funktionen
Gibt ein StringList-Objekt zurück, das den Satz veröffentlichter Features für das angegebene Produkt auflistet.
FeatureState
Gibt den installierten Zustand eines Features zurück.
FeatureUsageCount
Gibt zurück, wie oft das Feature verwendet wurde.
FeatureUsageDate
Gibt das Datum zurück, an dem das angegebene Feature zuletzt verwendet wurde.
Fileattributes
Gibt eine Zahl zurück, die die kombinierten Dateiattribute für den angegebenen Pfad zu einer Datei oder einem Ordner darstellt.
Patches
Gibt ein StringList-Objekt zurück, das alle auf das Produkt angewendeten Patches enthält.
PatchesEx
Enumeriert eine Auflistung von Patchobjekten.
PatchFiles
Gibt ein StringList-Objekt zurück, das eine Liste von Dateien enthält, die durch die bereitgestellte Liste von Patches aktualisiert werden können.
PatchInfo
Gibt Informationen zu einem Patch zurück.
PatchTransforms
Gibt die durch Semikolons getrennte Liste von Transformationen zurück, die sich im angegebenen Patchpaket befinden und auf das angegebene Produkt angewendet werden.
ProductElevated
Gibt TRUE zurück, wenn das Produkt verwaltet wird, oder False, wenn das Produkt nicht verwaltet wird.
Productinfo
Gibt den Wert des angegebenen Attributs für ein installiertes oder veröffentlichtes Produkt zurück.
ProductInfoFromScript
Gibt den Wert des angegebenen Attributs zurück, das in einem Ankündigungsskript gespeichert ist.
Produkte
Gibt ein StringList-Objekt zurück, das den Satz aller für den aktuellen Benutzer und Computer installierten oder angekündigten Produkte auflistet.
ProductsEx
Enumeriert eine Auflistung von Product-Objekten.
ProductState
Gibt die Installationsstatusinformationen für ein Produkt zurück.
QualifierDescription
Gibt eine Textzeichenfolge zurück, die die qualifizierte Komponente beschreibt.
RelatedProducts
Gibt ein StringList-Objekt zurück, das den Satz aller für den aktuellen Benutzer und Computer installierten oder angekündigten Produkte mit einer angegebenen UpgradeCode-Eigenschaft in der Eigenschaftentabelle auflistet.
ShortcutTarget
Überprüft eine Verknüpfung und gibt das Produkt, den Featurenamen und die Komponente zurück, falls verfügbar.
SummaryInformation
Gibt ein SummaryInfo-Objekt zurück, das zum Untersuchen, Aktualisieren und Hinzufügen von Eigenschaften zum Zusammenfassungsinformationsstream eines Pakets oder einer Transformation verwendet werden kann.
UILevel
Lesen/Schreiben
Gibt den Typ der Benutzeroberfläche an, die beim Öffnen und Verarbeiten nachfolgender Pakete im aktuellen Prozessbereich verwendet werden soll.
Version
Gibt die Zeichenfolgendarstellung der aktuellen Version des Windows Zurück.

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Installer 5.0 auf Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 auf Windows Server 2008 oder Windows Vista. Windows Installationsprogramm auf Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
IID _ IInstaller ist als 000C1090-0000-0000-C000-00000000046 definiert.

Weitere Informationen

Verwenden der Automation-Schnittstelle

Windows Skriptbeispiele für Installer