[This is preliminary documentation and subject to change.]
The MsiProvideQualifiedComponent function returns the full component path for a qualified component and performs any necessary installation. This function prompts for source if necessary and increments the usage count for the feature.
UINT MsiProvideQualifiedComponent(
LPCTSTR szComponent, // component ID
LPCTSTR szQualifier, // specifies which component to access
DWORD dwInstallMode, // the install mode
LPTSTR lpPathBuf, // in/out returned path, NULL if not needed
DWORD *pcchPathBuf // in/out buffer character count
);
Value | Meaning |
---|---|
INSTALLMODE_DEFAULT | Provide the component, performing any installation, if necessary. |
INSTALLMODE_EXISTING | Provide the component only if the feature exists, else return ERROR_FILE_NOT_FOUND. |
combination of the REINSTALLMODE flags | Call MsiReinstallFeature to reinstall feature using this parameter for the dwReinstallMode parameter, and then provide the component. |
If lpPathBuf is NULL, pcchBuf can be NULL.
Upon success of the MsiProvideQualifiedComponent function, the pcchPathBuf parameter contains the length of the string in lpPathBuf.
Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Windows CE: Unsupported.
Header: Declared in msi.h.
Import Library: Use msi.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.