Funzione MsiReinstallFeatureW (msi.h)

Articolo
11/20/2024

La funzione MsiReinstallFeature reinstalla le funzionalità.

Sintassi

UINT MsiReinstallFeatureW(
  [in] LPCWSTR szProduct,
  [in] LPCWSTR 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 gli elementi da installare. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
REINSTALLMODE_FILEMISSING	Reinstallare solo se il file è mancante.
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 è mancante o è una versione diversa.
REINSTALLMODE_FILEVERIFY	Verificare i valori di checksum e reinstallare il file se sono mancanti o danneggiati. Questo flag ripristina solo i file con msidbFileAttributesChecksum nella colonna Attributes 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 al 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 al 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, MIME Table, Icon Table, Extension Tablee AppID Table indipendentemente dal computer o dall'assegnazione dell'utente. Reinstallare tutti i componenti qualificati . Durante la reinstallazione di un'applicazione, questa opzione esegue le azioni RegisterTypeLibraries RegisterTypeLibraries e InstallODBC.
REINSTALLMODE_SHORTCUT	Reinstallare tutti i collegamenti e memorizzare nella cache tutte le icone sovrascrivendo tutte le icone e i collegamenti 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	L'installazione non è riuscita.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido.
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.

Osservazioni

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 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. 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 Requisiti di windows Run-Time.
piattaforma di destinazione	Finestre
intestazione	msi.h
libreria	Msi.lib
dll	Msi.dll

Vedere anche

le funzioni di installazione e configurazione

Multiple-Package installazioni

REINSTALLMODE, proprietà

Condividi tramite