Funzione MsiConfigureProductExA (msi.h)

Articolo
08/24/2023

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