Funzione MsiGetMode (msiquery.h)

  • Articolo

La funzione MsiGetMode viene usata per determinare se il programma di installazione è attualmente in esecuzione in una modalità specificata, come indicato nella tabella. La funzione restituisce un valore booleano TRUE o FALSE, che indica se la proprietà specifica passata alla funzione è attualmente impostata (TRUE) o non impostata (FALSE).

Sintassi

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

Parametri

[in] hInstall

Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] eRunMode

Specifica la modalità di esecuzione. Questo parametro deve avere uno dei valori seguenti.

Valore Significato
MSIRUNMODE_ADMIN
 La modalità amministrativa è l'installazione o l'installazione del prodotto.
MSIRUNMODE_ADVERTISE
 Gli annunci stanno installando o il prodotto sta installando o aggiornando.
MSIRUNMODE_MAINTENANCE
 Un'installazione esistente viene modificata o è disponibile una nuova installazione.
MSIRUNMODE_ROLLBACKENABLED
 Il rollback è abilitato.
MSIRUNMODE_LOGENABLED
 Il file di log è attivo. È stato abilitato prima della sessione di installazione.
MSIRUNMODE_OPERATIONS
 Le operazioni di esecuzione sono nella fase di determinazione.
MSIRUNMODE_REBOOTATEND
 Un riavvio è necessario dopo un'installazione completata (impostabile).
MSIRUNMODE_REBOOTNOW
 È necessario un riavvio per continuare l'installazione (impostabile).
MSIRUNMODE_CABINET
 I file provenienti da archivi e file di tabella media vengono installati.
MSIRUNMODE_SOURCESHORTNAMES
 L'origine LongFileNames viene eliminata tramite la proprietà di riepilogo PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES
 La proprietà LongFileNames di destinazione viene eliminata tramite la proprietà SHORTFILENAMES .
MSIRUNMODE_RESERVED11
 Riservato per utilizzi futuri.
MSIRUNMODE_WINDOWS9X
 Il sistema operativo è una versione 9x.
MSIRUNMODE_ZAWENABLED
 Il sistema operativo supporta l'installazione della richiesta.
MSIRUNMODE_RESERVED14
 Riservato per utilizzi futuri.
MSIRUNMODE_RESERVED15
 Riservato per utilizzi futuri.
MSIRUNMODE_SCHEDULED
 Azione personalizzata chiamata dall'esecuzione dello script di installazione.
MSIRUNMODE_ROLLBACK
 Azione personalizzata chiamata dallo script di esecuzione del rollback.
MSIRUNMODE_COMMIT
 Azione personalizzata chiamata dallo script di esecuzione del commit.

Valore restituito

TRUE indica che la proprietà specifica passata alla funzione è attualmente impostata.

FALSE indica che la proprietà specifica passata alla funzione non è attualmente impostata.

Commenti

Si noti che non tutti i valori della modalità di esecuzione di iRunMode sono disponibili quando si chiama MsiGetMode da un'azione personalizzata posticipata. Per informazioni dettagliate, vedere Ottenere informazioni sul contesto per azioni personalizzate di esecuzione posticipata.

Requisiti

   
Client minimo supportato 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
Piattaforma di destinazione Windows
Intestazione msiquery.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Funzioni di accesso allo stato del programma di installazione