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.
[in] eInstallState
Specifica lo stato di installazione per il prodotto. Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
Il prodotto deve essere installato con tutte le funzionalità installate in locale. |
|
Il prodotto viene disinstallato. |
|
Il prodotto deve essere installato con tutte le funzionalità installate per l'esecuzione dall'origine. |
|
Il prodotto deve essere installato con tutte le funzionalità installate negli stati predefiniti specificati nella tabella delle funzionalità. |
|
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 |
|---|---|
|
Alla funzione viene passato un parametro non valido. |
|
Funzione completata. |
|
Per altre informazioni, vedere Codici di errore. |
| 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