Funzione MsiReinstallProductA (msi.h)

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, PublishComponentTable, 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à