Funzione MsiReinstallFeatureA (msi.h)

  • Articolo

La funzione MsiReinstallFeature reinstalla le funzionalità.

Sintassi

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Parametri

[in] szProduct

Specifica il codice prodotto per il prodotto che contiene la funzionalità da reinstallare.

[in] szFeature

Specifica la funzionalità da reinstallare. La funzionalità padre o figlio della funzionalità specificata non viene reinstallata. Per reinstallare la funzionalità padre o figlio, è necessario chiamare la funzione MsiReinstallFeature per ogni funzione separatamente o usare la funzione MsiReinstallProduct .

[in] dwReinstallMode

Specifica cosa installare. 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 di classe, tabella verbo, PublishComponent Table, ProgID Table, MIME 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_FEATURE
 L'ID funzionalità non identifica una funzionalità nota.
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 MsiReinstallFeature 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

Installazioni multiple-package

REINSTALLMODE, proprietà