Session-Objekt (Windows Installer)

  • Artikel

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
Msi.dll
IID
 IID_ISession ist definiert als 000C109E-0000-0000-C000-000000000046

Siehe auch

Windows Installer-Skriptbeispiele