MsiInstallMissingComponent Function

Windows Installer

MsiInstallMissingComponent Function

The MsiInstallMissingComponent function installs files that are unexpectedly missing.

Syntax

C++UINT MsiInstallMissingComponent(
  __in  LPCTSTR szProduct,
  __in  LPCTSTR szComponent,
  __in  INSTALLSTATE eInstallState
);

Parameters

szProduct [in]

Specifies the product code for the product that owns the component to be installed.

szComponent [in]

Identifies the component to be installed.

eInstallState [in]

Specifies the way the component should be installed. This parameter must be one of the following values.

Value Meaning
INSTALLSTATE_LOCAL

The component should be locally installed.

INSTALLSTATE_SOURCE

The component should be installed to run from the source.

INSTALLSTATE_DEFAULT

The component should be installed according to the installer defaults.

 

Return Value

Value Meaning
ERROR_BAD_CONFIGURATION

The configuration information is corrupt.

ERROR_INSTALL_FAILURE

The installation failed.

ERROR_INSTALL_SOURCE_ABSENT

The source was unavailable.

ERROR_INSTALL_SUSPEND

The installation was suspended.

ERROR_INSTALL_USEREXIT

The user exited the installation.

ERROR_INVALID_PARAMETER

One of the parameters is invalid.

ERROR_SUCCESS

The function completed successfully.

ERROR_UNKNOWN_PRODUCT

The product code is unrecognized.

 

For more information about error messages, see Displayed Error Messages

Remarks

The MsiInstallMissingComponent function resolves the feature(s) that the component belongs to. Then, the product feature that requires the least additional disk space is installed.

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 namesMsiInstallMissingComponentW (Unicode) and MsiInstallMissingComponentA (ANSI)

See Also

Multiple-Package Installations

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.