Session-Objekt (Windows Installer)
Das Session-Objekt steuert den Installationsvorgang. Es öffnet die Installer-Datenbank, die die Installationstabellen und -daten enthält. Dieses Objekt ist einem Standardsatz von Aktionsfunktionen zugeordnet, die jeweils bestimmte Vorgänge für Daten aus einer oder mehreren Tabellen ausführen. Für bestimmte Produktinstallationen können zusätzliche benutzerdefinierte Aktionen hinzugefügt werden. Die grundlegende Engine-Funktion ist ein Sequenzer, der sequenzielle Datensätze aus einer angegebenen Sequenztabelle abruft, jeden angegebenen Bedingungsausdruck auswertet und die angegebene Aktion ausführt. Aktionen, die von der Engine nicht erkannt werden, werden zur Verarbeitung durch das Benutzeroberflächenhandler-Objekt (UI Handler) zurückgestellt, in der Regel Dialogfeldsequenzen.
Beachten Sie, dass nur ein Session-Objekt von einem einzelnen Prozess geöffnet werden kann.
Member
Das Session-Objekt weist auch die folgenden Arten von Membern auf:
Methoden
Das Session-Objekt verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| DoAction | Führt die angegebene Aktion aus. |
| EvaluateCondition | Wertet einen logischen Ausdruck aus, der Symbole und Werte enthält, und gibt eine ganze Zahl der Enumeration „msiEvaluateConditionErrorEnum“ zurück. |
| FeatureInfo | Gibt ein FeatureInfo-Objekt zurück, das beschreibende Informationen für das angegebene Feature enthält. |
| FormatRecord | Gibt eine formatierte Zeichenfolge aus Vorlagen- und Datensatzdaten zurück. |
| Message | Führt alle aktivierten Protokollierungsvorgänge aus und stellt die Ausführung an das Benutzeroberflächenhandler-Objekt (UI Handler) zurück, das der Engine zugeordnet ist. |
| Sequence | Öffnet eine Abfrage für die angegebene Tabelle, wobei die Aktionen nach den Zahlen in der Sequence-Spalte sortiert werden. Für jede abgerufene Zeile wird die DoAction-Methode aufgerufen, vorausgesetzt, dass jeder angegebene Bedingungsausdruck nicht zu False ausgewertet wird. |
| SetInstallLevel | Legt die Installationsebene für die aktuelle Installation auf einen angegebenen Wert fest und berechnet die Zustände „Select“ und „Installed“ für alle Features neu. |
Eigenschaften
Das Session-Objekt verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
|
ComponentCosts |
Gibt ein RecordList-Objekt zurück, das den Speicherplatz pro Laufwerk auflistet, der für die Installation einer Komponente erforderlich ist. |
|
|
ComponentCurrentState |
Gibt den aktuellen installierten Zustand der angegebenen Komponente zurück. |
|
|
ComponentRequestState |
Ruft eine Änderung des Action-Zustands einer Zeile in der Component-Tabelle ab oder fordert sie an. |
|
|
Datenbank |
Gibt die Datenbank für die aktuelle Installationssitzung zurück. |
|
|
FeatureCost |
Gibt den gesamten Datenträgerspeicherplatz (in Einheiten von 512 Bytes) zurück, der für das angegebene Feature und seine übergeordneten Feature (bis zum Stamm der Feature-Tabelle) erforderlich ist. |
|
|
FeatureCurrentState |
Gibt den aktuellen installierten Zustand des angegebenen Features zurück. |
|
|
FeatureRequestState |
Lesen/Schreiben |
Ruft eine Änderung des Select-Zustands des Datensatzes und der Unterdatensätze eines Features ab oder fordert diese an. |
|
FeatureValidStates |
Gibt eine ganze Zahl zurück, die Bitflags darstellt, wobei jedes relevante Bit einen gültigen Installationszustand für das angegebene Feature darstellt. |
|
|
Installer |
Gibt das aktive Installer-Objekt zurück. |
|
|
Language (Session Object) |
Stellt den numerischen Sprachbezeichner dar, der von der aktuellen Installationssitzung verwendet wird. |
|
|
Mode |
Diese Eigenschaft ist ein Wert, der das angegebene Modusflag für die aktuelle Installationssitzung darstellt. |
|
|
ProductProperty |
Stellt den Zeichenfolgenwert einer benannten Installereigenschaft dar. |
|
|
Property (Session-Objekt) |
Lesen/Schreiben |
Ruft Produkteigenschaften aus der Produktdatenbank ab. |
|
SourcePath |
Stellt den vollständigen Pfad zum angegebenen Ordner auf dem Quellmedium oder im Serverimage bereit. |
|
|
TargetPath |
Lesen/Schreiben |
Stellt den vollständigen Pfad zum angegebenen Ordner auf dem Ziellaufwerk für die Installation bereit. |
|
VerifyDiskSpace |
Gibt „true“ zurück, wenn genügend Speicherplatz vorhanden ist, und „false“, wenn der Datenträger voll ist. |
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_ISession ist definiert als 000C109E-0000-0000-C000-000000000046 |
Siehe auch