Freigeben über


Installer-Objekt

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

Sie können das Installer-Objekt über die ProgId „WindowsInstaller.Installer“ erstellen.

Member

Das Installer-Objekt weist die folgenden Arten von Membern auf:

Methoden

Das Installer-Objekt umfasst die folgenden Methoden.

Methode BESCHREIBUNG
AddSource Fügt der Liste der gültigen Netzwerkquellen in der Quellliste eine Quelle hinzu.
AdvertiseProduct Kündigt ein Installationspaket an.
AdvertiseScript Kündigt ein Installationspaket an.
ApplyMultiplePatches Wendet einen oder mehrere Patches auf Produkte an, die den Patch erhalten können. 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 im Patchpaket als zum Erhalt des Patches berechtigt aufgeführt ist.
ClearSourceList Entfernt alle Netzwerkquellen aus der Quellliste.
CollectUserInfo Ruft eine Sequenz des Benutzeroberflächen-Assistenten auf, die sowohl Benutzerinformationen als auch den Produktcode erfasst und speichert.
ConfigureFeature Konfiguriert den Installationsstatus eines Produktfeatures.
ConfigureProduct Installiert oder deinstalliert ein Produkt.
CreateAdvertiseScript Generiert ein Ankündigungsskript.
CreateRecord Gibt ein neues Record-Objekt mit der angeforderten Anzahl von Feldern zurück.
EnableLog Aktiviert die Protokollierung des ausgewählten Meldungstyps für alle nachfolgenden Installationssitzungen im aktuellen Prozessbereich.
ExtractPatchXMLData Extrahiert Informationen aus einem Patch als XML-Zeichenfolge.
FileHash Verwendet den Pfad zu einer Datei und gibt einen 128-Bit-Hash dieser Datei zurück.
FileSignatureInfo Verwendet 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 Versions- oder Sprachzeichenfolge des angegebenen Pfads zurück.
ForceSourceListResolution Erzwingt, dass der Installer die Quellliste nach einer gültigen Produktquelle durchsucht, wenn das nächste Mal eine Quelle benötigt wird.
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 bestehende Datenbank oder erstellt eine neue Datenbank.
OpenPackage Öffnet ein Installationspaket zur Verwendung mit Funktionen, die auf die Produktdatenbank und das Installationsmodul zugreifen.
OpenProduct Öffnet ein Installationspaket für ein installiertes Produkt anhand des Produktcodes.
ProvideAssembly Gibt den Installationspfad 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 oder -wert.
ReinstallFeature Installiert Features neu oder behebt Probleme mit installierten Features.
ReinstallProduct Installiert ein Produkt neu oder behebt Installationsprobleme bei einem installierten Produkt.
RemovePatches Entfernt einen oder mehrere Patches von Produkten, die den Patch erhalten können.
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 die folgenden Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
ClientsEx
Gibt ein RecordList-Objekt zurück, das Produkte auflistet, die eine bestimmte installierte Komponente verwenden.
Windows Installer 4.5 und früher: Nicht unterstützt.
ComponentClients
Gibt ein StringList-Objekt zurück, das die Clients einer bestimmten 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 bestimmten installierten Komponente angibt.
Windows Installer 4.5 und früher: Nicht unterstützt.
ComponentQualifiers
Gibt ein StringList-Objekt zurück, das die registrierten Qualifizierer für die angegebene Komponente auflistet.
Komponenten
Gibt ein StringList-Objekt zurück, das die installierten Komponenten für alle Produkte auflistet.
ComponentsEx
Gibt ein RecordList-Objekt zurück, das die installierten Komponenten auflistet.
Windows Installer 4.5 und früher: 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 die veröffentlichten Features für das angegebene Produkt auflistet.
FeatureState
Gibt den Installationsstatus 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
Listet eine Sammlung von Patch-Objekten auf.
PatchFiles
Gibt ein StringList-Objekt zurück, das eine Liste von Dateien enthält, die anhand der angegebenen Liste von Patches aktualisiert werden können.
PatchInfo
Gibt Informationen zu einem Patch zurück.
PatchTransforms
Gibt die durch Trennzeichen (Semikolon) getrennte Liste der Transformationen zurück, die im angegebenen Patchpaket enthalten sind und auf das angegebene Produkt angewendet werden.
ProductElevated
Gibt „True“ zurück, wenn das Produkt verwaltet wird, und gibt „False“ zurück, 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 alle für den aktuellen Benutzer und Computer installierten oder angekündigten Produkte auflistet.
ProductsEx
Listet eine Sammlung von Product-Objekten auf.
ProductState
Gibt die Installationsstatusinformationen für ein Produkt zurück.
QualifierDescription
Gibt eine Textzeichenfolge zur Beschreibung der qualifizierten Komponente zurück.
RelatedProducts
Gibt ein StringList-Objekt zurück, das alle für den aktuellen Benutzer und Computer installierten oder angekündigten Produkte mit einer festgelegten UpgradeCode-Eigenschaft in der Eigenschaftentabelle auflistet.
ShortcutTarget
Untersucht 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 und Aktualisieren sowie zum Hinzufügen von Eigenschaften zum Zusammenfassungsinformations-Datenstrom 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 Windows Installer-Version zurück.

 

Anforderungen

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

Siehe auch

Verwenden der Automation-Schnittstelle

Windows Installer-Skriptbeispiele