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 |
|
| IID |
IID _ IInstaller ist als 000C1090-0000-0000-C000-00000000046 definiert. |