Funzione MsiReinstallProductA (msi.h)

Articolo
08/24/2023

La funzione MsiReinstallProduct reinstalla i prodotti.

Sintassi

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

Parametri

[in] szProduct

Specifica il codice prodotto per il prodotto da reinstallare.

[in] szReinstallMode

Specifica la modalità di reinstallazione. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
REINSTALLMODE_FILEMISSING	Reinstallare solo se il file non è presente.
REINSTALLMODE_FILEOLDERVERSION	Reinstallare se il file è mancante o è una versione precedente.
REINSTALLMODE_FILEEQUALVERSION	Reinstallare se il file è mancante o è una versione uguale o precedente.
REINSTALLMODE_FILEEXACT	Reinstallare se il file manca o è una versione diversa.
REINSTALLMODE_FILEVERIFY	Verificare i valori checksum e reinstallare il file se mancanti o danneggiati. Questo flag ripristina solo i file con msidbFileAttributesChecksum nella colonna Attributi della tabella File.
REINSTALLMODE_FILEREPLACE	Forzare la reinstallazione di tutti i file, indipendentemente dal checksum o dalla versione.
REINSTALLMODE_USERDATA	Riscrivere tutte le voci del Registro di sistema necessarie dalla tabella del Registro di sistema che passano alla HKEY_CURRENT_USER o HKEY_USERS hive del Registro di sistema.
REINSTALLMODE_MACHINEDATA	Riscrivere tutte le voci del Registro di sistema necessarie dalla tabella del Registro di sistema che passano alla HKEY_LOCAL_MACHINE o HKEY_CLASSES_ROOT hive del Registro di sistema. Riscrivere tutte le informazioni della tabella classe, tabella verbo, PublishComponent Table, ProgID Table, MIMET Table, Icon Table, Extension Table e AppID Table indipendentemente dall'assegnazione di computer o utente. Reinstallare tutti i componenti qualificati. Quando si reinstalla un'applicazione, questa opzione esegue le azioni RegisterTypeLibraries e InstallODBC .
REINSTALLMODE_SHORTCUT	Reinstallare tutti i collegamenti e memorizzare nella cache tutte le icone sovrascrivendo qualsiasi collegamento e icone esistenti.
REINSTALLMODE_PACKAGE	Usare per eseguire dal pacchetto di origine e memorizzare nuovamente nella cache il pacchetto locale. Non usare per la prima installazione di un'applicazione o di una funzionalità.

Valore restituito

Codice restituito	Descrizione
ERROR_INSTALL_FAILURE	Operazione di installazione non riuscita.
ERROR_INVALID_PARAMETER	Un parametro non valido è stato passato alla funzione.
ERROR_INSTALL_SERVICE_FAILURE	Impossibile accedere al servizio di installazione.
ERROR_INSTALL_SUSPEND	L'installazione è stata sospesa ed è incompleta.
ERROR_INSTALL_USEREXIT	L'utente ha annullato l'installazione.
ERROR_SUCCESS	La funzione è stata completata correttamente.
ERROR_UNKNOWN_PRODUCT	Il codice prodotto non identifica un prodotto noto.

Per altre informazioni, vedere Messaggi di errore visualizzati.

Commenti

Nota

L'intestazione msi.h definisce MsiReinstallProduct come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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. 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 i requisiti di Windows Installer Run-Time.
Piattaforma di destinazione	Windows
Intestazione	msi.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni di installazione e configurazione

Più installazioni di pacchetti

REINSTALLMODE, proprietà

Condividi tramite