Funzione MsiSetInstallLevel (msiquery.h)

  • Articolo

La funzione MsiSetInstallLevel imposta il livello di installazione per un'installazione completa del prodotto.

Sintassi

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

Parametri

[in] hInstall

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

[in] iInstallLevel

Livello di installazione.

Valore restituito

La funzione MsiSetInstallLevel restituisce uno dei valori seguenti:

Commenti

La funzione MsiSetInstallLevel imposta quanto segue:

  • Livello di installazione per l'installazione corrente in un valore specificato.
  • Stati Seleziona e Installati per tutte le funzionalità della tabella Funzionalità.
  • Stato Azione di ogni componente nella tabella Componente, in base al nuovo livello.
Per qualsiasi installazione, esiste un livello di installazione definito, ovvero un valore integrale compreso tra 1 e 32.767. Il valore iniziale è determinato dalla proprietà INSTALLLEVEL , impostata nella tabella delle proprietà.

Se viene passato 0 (zero) o un numero negativo nel parametro iInstallLevel , il livello di installazione corrente non cambia, ma tutte le funzionalità vengono comunque aggiornate in base al livello di installazione corrente. Per altre informazioni, vedere Chiamata di funzioni di database da programmi.

Se la funzione ha esito negativo, è possibile ottenere informazioni estese sull'errore usando MsiGetLastErrorRecord.

Requisiti

Requisito Valore
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 selezione del programma di installazione