Funzione MsiConfigureProductA (msi.h)

Articolo
11/20/2024

La funzione MsiConfigureProduct installa o disinstalla un prodotto.

Sintassi

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

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. Il parametro iInstallLevel viene ignorato e tutte le funzionalità vengono installate, se il parametro eInstallState è impostato su qualsiasi valore diverso da INSTALLSTATE_DEFAULT.

Questo parametro può essere 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ò essere 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.

Valore restituito

Valore	Significato
ERROR_INVALID_PARAMETER	Alla funzione viene passato un parametro non valido.
ERROR_SUCCESS	La funzione ha esito positivo.
Errore correlato a un'azione	Per altre informazioni, vedere codici di errore .
errore di inizializzazione	Errore correlato all'inizializzazione.

Osservazioni

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

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.

Nota

L'intestazione msi.h definisce MsiConfigureProduct 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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. Per informazioni sul Service Pack minimo di Windows richiesto da una versione di Windows Installer, vedere Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

Multiple-Package installazioni

Condividi tramite