MsiReinstallProductA function (msi.h)
The MsiReinstallProduct function reinstalls products.
Syntax
UINT MsiReinstallProductA(
[in] LPCSTR szProduct,
[in] DWORD szReinstallMode
);
Parameters
[in] szProduct
Specifies the product code for the product to be reinstalled.
[in] szReinstallMode
Specifies the reinstall mode. This parameter can be one or more of the following values.
| Value | Meaning |
|---|---|
|
Reinstall only if the file is missing. |
|
Reinstall if the file is missing or is an older version. |
|
Reinstall if the file is missing, or is an equal or older version. |
|
Reinstall if the file is missing or is a different version. |
|
Verify the checksum values and reinstall the file if they are missing or corrupt. This flag only repairs files that have msidbFileAttributesChecksum in the Attributes column of the File table. |
|
Force all files to be reinstalled, regardless of checksum or version. |
|
Rewrite all required registry entries from the Registry Table that go to the HKEY_CURRENT_USER or HKEY_USERS registry hive. |
|
Rewrite all required registry entries from the
Registry Table that go to the HKEY_LOCAL_MACHINE or HKEY_CLASSES_ROOT registry hive. Rewrite all information from the
Class Table,
Verb Table,
PublishComponent Table,
ProgID Table,
MIMET Table,
Icon Table,
Extension Table, and
AppID Table regardless of machine or user assignment. Reinstall all
qualified components.
When reinstalling an application, this option runs the RegisterTypeLibraries and InstallODBC actions. |
|
Reinstall all shortcuts and re-cache all icons overwriting any existing shortcuts and icons. |
|
Use to run from the source package and re-cache the local package. Do not use for the first installation of an application or feature. |
Return value
| Return code | Description |
|---|---|
|
The installation failed. |
|
An invalid parameter was passed to the function. |
|
The installation service could not be accessed. |
|
The installation was suspended and is incomplete. |
|
The user canceled the installation. |
|
The function completed successfully. |
|
The product code does not identify a known product. |
For more information, see Displayed Error Messages.
Remarks
Note
The msi.h header defines MsiReinstallProduct as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version. |
| Target Platform | Windows |
| Header | msi.h |
| Library | Msi.lib |
| DLL | Msi.dll |
See also
Installation and Configuration Functions