The
MsiInstallProduct function installs or uninstalls a product.
Syntax
UINT MsiInstallProduct(
__in LPCTSTR szPackagePath,
__in LPCTSTR szCommandLine
);
Parameters
- szPackagePath [in]
-
A null-terminated string that specifies the path to the location of the Windows Installer package. The string value can contain a URL (e.g. http://packageLocation/package/package.msi), a network path (e.g. \\packageLocation\package.msi), a file path (e.g. file://packageLocation/package.msi), or a local path (e.g. D:\packageLocation\package.msi).
- szCommandLine [in]
-
A null-terminated string that specifies the command line property settings. This should be a list of the format Property=Setting Property=Setting. For more information, see
About Properties.
To perform an administrative installation, include ACTION=ADMIN in szCommandLine. For more information, see the
ACTION property.
Return Value
| Value | Meaning |
- ERROR_SUCCESS
| The function completes successfully.
|
- An error relating to an action
| For more information, see
Error Codes.
|
- Initialization Error
| An error that relates to initialization occurred.
|
For more information, see
Displayed Error Messages.
Remarks
The
MsiInstallProduct function displays the user interface with the current settings and log mode.
For more information, see
REMOVE Property.
Requirements
| Version | Windows Installer 5.0 on 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, Windows XP, and Windows 2000. See the Windows Installer Run-Time Requirements for information about the minimum Microsoft Windows service pack that is required by a Windows Installer version. |
| Header | Msi.h |
| Library | Msi.lib |
| DLL | Msi.dll |
| Unicode and ANSI names | MsiInstallProductW (Unicode) and MsiInstallProductA (ANSI) |
See Also
- Displayed Error Messages
- Error Codes
- Initialization Error
- Installation and Configuration Functions
- Multiple-Package Installations
Send comments about this topic to Microsoft
Build date: 6/25/2009