Oggetto Session (Windows Installer)
L'oggetto Session controlla il processo di installazione. Apre il database del programma di installazione, che contiene le tabelle e i dati di installazione. Questo oggetto è associato a un set standard di funzioni di azione, ognuna delle quali esegue operazioni specifiche sui dati di una o più tabelle. È possibile aggiungere altre azioni personalizzate per specifiche installazioni di prodotti. La funzione del motore di base è un sequencer che recupera i record sequenziali da una tabella di sequenza designata, valuta qualsiasi espressione di condizione specificata ed esegue l'azione designata. Le azioni non riconosciute dal motore vengono posticipate all'oggetto gestore dell'interfaccia utente per l'elaborazione, in genere sequenze di finestre di dialogo.
Si noti che un solo oggetto Session può essere aperto da un singolo processo.
Membri
L'oggetto Session ha questi tipi di membri:
Metodi
L'oggetto Session dispone di questi metodi.
| Metodo | Descrizione |
|---|---|
| DoAction | Esegue l'azione specificata. |
| EvaluateCondition | Valuta un'espressione logica contenente simboli e valori e restituisce un numero intero dell'enumerazione msiEvaluateConditionErrorEnum. |
| FeatureInfo | Restituisce un oggetto FeatureInfo contenente informazioni descrittive per la funzionalità specificata. |
| FormatRecord | Restituisce una stringa formattata dai dati del modello e dei record. |
| Messaggio | Esegue tutte le operazioni di registrazione abilitate e rinvia l'esecuzione all'oggetto gestore dell'interfaccia utente associato al motore. |
| Sequenza | Apre una query sulla tabella specificata, ordinando le azioni in base ai numeri nella colonna Sequenza. Per ogni riga recuperata, viene chiamato il metodo DoAction , a condizione che qualsiasi espressione di condizione fornita non restituisca False. |
| SetInstallLevel | Imposta il livello di installazione per l'installazione corrente su un valore specificato e ricalcola gli stati Seleziona e Installato per tutte le funzionalità. |
Proprietà
L'oggetto Session ha queste proprietà.
| Proprietà | Tipo di accesso | Descrizione |
|---|---|---|
|
ComponentCosts |
Restituisce un oggetto RecordList che enumera lo spazio su disco per unità necessaria per installare un componente. |
|
|
ComponentCurrentState |
Restituisce lo stato di installazione corrente del componente designato. |
|
|
ComponentRequestState |
Ottiene o richiede una modifica nello stato Azione di una riga nella tabella Componente. |
|
|
Database |
Restituisce il database per la sessione di installazione corrente. |
|
|
FeatureCost |
Restituisce la quantità totale di spazio su disco ,in unità di 512 byte, richiesta dalla funzionalità specificata e dalle relative caratteristiche padre (fino alla radice della tabella Feature). |
|
|
FeatureCurrentState |
Restituisce lo stato di installazione corrente della funzionalità designata. |
|
|
FeatureRequestState |
Lettura/Scrittura |
Ottiene o richiede una modifica nello stato Select del record e delle sottocorde di una funzionalità. |
|
FeatureValidStates |
Restituisce un numero intero che rappresenta i flag di bit con ogni bit pertinente che rappresenta uno stato di installazione valido per la funzionalità specificata. |
|
|
Installer |
Restituisce l'oggetto programma di installazione attivo. |
|
|
Language (oggetto Session) |
Rappresenta l'identificatore di lingua numerico utilizzato dalla sessione di installazione corrente. |
|
|
Mode |
Questa proprietà è un valore che rappresenta il flag di modalità designato per la sessione di installazione corrente. |
|
|
ProductProperty |
Rappresenta il valore stringa di una proprietà del programma di installazione denominata. |
|
|
Proprietà (oggetto Session) |
Lettura/Scrittura |
Recupera le proprietà del prodotto dal database del prodotto. |
|
Sourcepath |
Fornisce il percorso completo della cartella designata nel supporto di origine o nell'immagine del server. |
|
|
Targetpath |
Lettura/Scrittura |
Fornisce il percorso completo della cartella designata nell'unità di destinazione dell'installazione. |
|
VerifyDiskSpace |
Restituisce true se esiste spazio su disco sufficiente e false se il disco è pieno. |
Requisiti
| Requisito | Valore |
|---|---|
| Versione |
Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP |
| DLL |
|
| IID |
IID_ISession è definito come 000C109E-0000-0000-C000-000000000046 |
Vedi anche