Funzione MsiConfigureProductExA (msi.h)

La funzione MsiConfigureProductEx installa o disinstalla un prodotto. È anche possibile specificare una riga di comando del prodotto.

Sintassi

UINT MsiConfigureProductExA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState,
  [in] LPCSTR       szCommandLine
);

Parametri

[in] szProduct

Specifica il codice prodotto per il prodotto da configurare.

[in] iInstallLevel

Specifica la quantità di prodotto da installare durante l'installazione del prodotto nello stato predefinito. I parametri iInstallLevel vengono ignorati e vengono installate tutte le funzionalità, se il parametro eInstallState è impostato su qualsiasi valore diverso da INSTALLSTATE_DEFAULT.

Questo parametro può avere uno dei valori seguenti.

Valore Significato
INSTALLLEVEL_DEFAULT
Vengono installate le funzionalità predefinite create.
INSTALLLEVEL_MINIMUM
Vengono installate solo le funzionalità necessarie. È possibile specificare un valore tra INSTALLLEVEL_MINIMUM e INSTALLLEVEL_MAXIMUM per installare un subset di funzionalità disponibili.
INSTALLLEVEL_MAXIMUM
Vengono installate tutte le funzionalità. È possibile specificare un valore tra INSTALLLEVEL_MINIMUM e INSTALLLEVEL_MAXIMUM per installare un subset di funzionalità disponibili.

[in] eInstallState

Specifica lo stato di installazione per il prodotto. Questo parametro può avere uno dei valori seguenti.

Valore Significato
INSTALLSTATE_LOCAL
Il prodotto deve essere installato con tutte le funzionalità installate in locale.
INSTALLSTATE_ABSENT
Il prodotto viene disinstallato.
INSTALLSTATE_SOURCE
Il prodotto deve essere installato con tutte le funzionalità installate per l'esecuzione dall'origine.
INSTALLSTATE_DEFAULT
Il prodotto deve essere installato con tutte le funzionalità installate negli stati predefiniti specificati nella tabella delle funzionalità.
INSTALLSTATE_ADVERTISED
Il prodotto viene pubblicizzato.

[in] szCommandLine

Specifica le impostazioni delle proprietà della riga di comando. Deve essere un elenco del formato Property=Setting Property=Setting. Per altre informazioni, vedere Informazioni sulle proprietà.

Valore restituito

Valore Significato
ERROR_INVALID_PARAMETER
Alla funzione viene passato un parametro non valido.
ERROR_SUCCESS
Funzione completata.
Errore correlato a un'azione
Per altre informazioni, vedere Codici di errore.
Errore di inizializzazione
Si è verificato un errore relativo all'inizializzazione.

Commenti

La riga di comando passata come szCommandLine può contenere una delle proprietà delle opzioni di installazione delle funzionalità. In questo caso, eInstallState passato deve essere INSTALLSTATE_DEFAULT.

Il parametro iInstallLevel viene ignorato e tutte le funzionalità del prodotto vengono installate se il parametro eInstallState è impostato su qualsiasi valore diverso da INSTALLSTATE_DEFAULT. Per controllare l'installazione di singole funzionalità quando il parametro eInstallState non è impostato su INSTALLSTATE_DEFAULT usare MsiConfigureFeature.

La funzione MsiConfigureProductEx visualizza l'interfaccia utente usando le impostazioni correnti. Le impostazioni dell'interfaccia utente possono essere modificate con MsiSetInternalUI, MsiSetExternalUI o MsiSetExternalUIRecord.

Nota

L'intestazione msi.h definisce MsiConfigureProductEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Windows Installer Run-Time Requirements .See the Windows Installer requirements for information about the minimum Windows Service Pack that is required by a Windows Installer version.
Piattaforma di destinazione Windows
Intestazione msi.h
Libreria Msi.lib
DLL Msi.dll

Vedi anche

Messaggi di errore visualizzati

Codici errore

Errore di inizializzazione

Funzioni di installazione e configurazione

Installazioni di più pacchetti