Funzione MsiConfigureProductA (msi.h)

  • Articolo

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 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.

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.

Commenti

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 vengono installate tutte le funzionalità del prodotto, 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 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

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 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

Installazioni di più pacchetti