Edit

Share via

MsiInstallMissingComponentA function (msi.h)

  • Article

The MsiInstallMissingComponent function installs files that are unexpectedly missing.

Syntax

UINT MsiInstallMissingComponentA(
  [in] LPCSTR       szProduct,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE eInstallState
);

Parameters

[in] szProduct

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

[in] szComponent

Identifies the component to be installed.

[in] eInstallState

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.

Note

The msi.h header defines MsiInstallMissingComponent 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

Multiple-Package Installations