MsiInstallProduct Function

Windows Installer

MsiInstallProduct Function

The MsiInstallProduct function installs or uninstalls a product.

Syntax

C++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

VersionWindows 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 Windows service pack that is required by a Windows Installer version.
HeaderMsi.h
LibraryMsi.lib
DLLMsi.dll
Unicode and ANSI namesMsiInstallProductW (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: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.