Condividi tramite


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
Msi.dll
IID
IID_ISession è definito come 000C109E-0000-0000-C000-000000000046

Vedi anche

Esempi di scripting di Windows Installer