The MsiQueryComponentState function returns the installed state for a component. This function can query for a component of an instance of a product that is installed under user accounts other than the current user provided the product is not advertised under the per-user-unmanaged context for a user account other than the current user. The calling process must have administrative privileges to get information for a product installed for a user other than the current user.

Syntax

C++UINT MsiQueryComponentState(
  __in   LPTSTR szProductCode,
  __in   LPTSTR szUserSid,
  __in   MSIINSTALLCONTEXT dwContext,
  __in   LPCTSTR szComponent,
  __out  INSTALLSTATE *pdwState
);

Parameters

szProductCode [in]

Specifies the ProductCode GUID for the product that contains the component.

szUserSid [in]

Specifies the security identifier (SID) of the account under which the instance of the product being queried exists. If dwContext is not MSIINSTALLCONTEXT_MACHINE, null specifies the current user.

Type of SID	Meaning
NULL	NULL denotes the currently logged on user.
User SID	Specifies enumeration for a particular user in the system. An example of user SID is "S-1-3-64-2415071341-1358098788-3127455600-2561".

 

Note  The special SID string s-1-5-18 (system) cannot be used to enumerate products installed as per-machine. If dwContext is MSIINSTALLCONTEXT_MACHINE, szUserSid must be null.

dwContext [in]

The installation context of the product instance being queried.

Name	Meaning
MSIINSTALLCONTEXT_USERMANAGED	Retrieves the component's state for the per–user–managed instance of the product.
MSIINSTALLCONTEXT_USERUNMANAGED	Retrieves the component's state for the per–user–non-managed instance of the product.
MSIINSTALLCONTEXT_MACHINE	Retrieves the component's state for the per-machine instance of the product.

 

szComponent [in]

Specifies the component being queried. Component code GUID of the component as found in the ComponentID column of the Component table.

pdwState [out]

Installation state of the component for the specified product instance. This parameter can return one of the following or null values.

Value	Meaning
INSTALLSTATE_LOCAL	The component is installed locally.
INSTALLSTATE_SOURCE	The component is installed to run from the source.

 

Return Value

The MsiQueryComponentState function returns the following values.

For more information, see Displayed Error Messages.

Remarks

Windows Installer 2.0:  Not supported. The MsiQueryComponentState function is available beginning with Windows Installer 3.0.

Requirements

See Also

Component

Displayed Error Messages

Installer Selection Functions

ProductCode

Send comments about this topic to Microsoft

Build date: 8/13/2009