Funzione MsiInstallProductA (msi.h)

Articolo
11/20/2024

La funzione msiInstallProduct installa o disinstalla un prodotto.

Sintassi

UINT MsiInstallProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szCommandLine
);

Parametri

[in] szPackagePath

Stringa con terminazione Null che specifica il percorso del pacchetto di Windows Installer. Il valore stringa può contenere un URL (ad esempio http://packageLocation/package/package.msi), un percorso di rete (ad esempio \packageLocation\package.msi), un percorso di file (ad esempio file://packageLocation/package.msi) o un percorso locale (ad esempio, D:\packageLocation\package.msi).

[in] szCommandLine

Stringa con terminazione Null che 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à.

Per eseguire un'installazione amministrativa, includere ACTION=ADMIN in szCommandLine. Per altre informazioni, vedere la proprietà ACTION.

Valore restituito

Valore	Significato
ERROR_SUCCESS	La funzione viene completata correttamente.
Errore relativo a un'azione	Per altre informazioni, vedere codici di errore .
errore di inizializzazione	Si è verificato un errore relativo all'inizializzazione.

Per altre informazioni, vedere Messaggi di errore visualizzati.

Osservazioni

La funzione MsiInstallProduct visualizza l'interfaccia utente con le impostazioni correnti e la modalità di log.

È possibile modificare le impostazioni dell'interfaccia utente usando le funzioniMsiSetInternalUI MsiSetExternalUIo MsiSetExternalUIRecord.
È possibile impostare la modalità di log usando la funzione msiEnableLog .
È possibile rimuovere completamente un prodotto impostando REMOVE=ALL in szCommandLine.

Per altre informazioni, vedere REMOVE Property.

Nota

L'intestazione msi.h definisce MsiInstallProduct 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. 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

messaggi di errore visualizzati

codici di errore

errore di inizializzazione

le funzioni di installazione e configurazione

Multiple-Package installazioni

Condividi tramite