MsiSetComponentStateA function

The MsiSetComponentState function sets a component to the requested state.

Syntax

UINT MsiSetComponentStateA(
  MSIHANDLE    hInstall,
  LPCSTR       szComponent,
  INSTALLSTATE iState
);

Parameters

hInstall

Handle to the installation provided to a DLL custom action or obtained through MsiOpenPackage, MsiOpenPackageEx, or MsiOpenProduct.

szComponent

Specifies the name of the component.

iState

Specifies the state to set. This parameter can be one of the following values.

Value Meaning
INSTALLSTATE_ABSENT
The component was uninstalled.
INSTALLSTATE_LOCAL
The component was installed on the local drive.
INSTALLSTATE_SOURCE
The component will run from source, CD, or network.

Return Value

The MsiSetComponentState function returns the following values:

Remarks

The MsiSetComponentState function requests a change in the Action state of a record in the Component table.

For more information, see Calling Database Functions From Programs.

If the function fails, you can obtain extended error information by using MsiGetLastErrorRecord.

Requirements

   
Windows version 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
Target Platform Windows
Header msiquery.h
Library Msi.lib
DLL Msi.dll

See Also

Installer Selection Functions