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.
UINT MsiQueryComponentStateA( LPCSTR szProductCode, LPCSTR szUserSid, MSIINSTALLCONTEXT dwContext, LPCSTR szComponentCode, INSTALLSTATE *pdwState );
Specifies the ProductCode GUID for the product that contains the component.
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 denotes the currently logged on user.|
||Specifies enumeration for a particular user in the system. An example of user SID is "S-1-3-64-2415071341-1358098788-3127455600-2561".|
The installation context of the product instance being queried.
Specifies the component being queried. Component code GUID of the component as found in the ComponentID column of the Component table.
Installation state of the component for the specified product instance. This parameter can return one of the following or null values.
||The component is installed locally.|
||The component is installed to run from the source.|
The MsiQueryComponentState function returns the following values.
||The calling process must have administrative privileges to get information for a product installed for a user other than the current user.|
||The configuration data is corrupt.|
||An invalid parameter was passed to the function.|
||The function completed successfully.|
||The component ID does not identify a known component.|
||The product code does not identify a known product.|
||Failures that cannot be ascribed to any Windows error code.|
||Buffer too small to get the user SID.|
For more information, see Displayed Error Messages.
|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. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.|