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 |
|
| IID |
IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046 |
Siehe auch