Функция MsiLocateComponentA (msi.h)
Функция MsiLocateComponent возвращает полный путь к установленному компоненту без кода продукта. Эта функция пытается определить продукт с помощью MsiGetProductCode, но не гарантирует, что он будет находить правильный продукт для вызывающего объекта. По возможности всегда следует вызывать MsiGetComponentPath.
Синтаксис
INSTALLSTATE MsiLocateComponentA(
[in] LPCSTR szComponent,
[out] LPSTR lpPathBuf,
[in, out] LPDWORD pcchBuf
);
Параметры
[in] szComponent
Указывает идентификатор компонента, который необходимо найти.
[out] lpPathBuf
Указатель на переменную, получающую путь к компоненту. Переменная содержит завершающий символ NULL.
[in, out] pcchBuf
Указатель на переменную, указывающую размер буфера в символах, на который указывает параметр lpPathBuf . Во входных данных это полный размер буфера, включая пробел для завершающего символа NULL. При успешном выполнении функции MsiLocateComponent переменная, на которую указывает pcchBuf , содержит количество символов, не включая завершающий символ NULL. Если размер переданного буфера слишком мал, функция возвращает INSTALLSTATE_MOREDATA.
Если lpPathBuf имеет значение NULL, pcchBuf может иметь значение NULL.
Возвращаемое значение
| Значение | Значение |
|---|---|
|
Запрашиваемый компонент отключен на компьютере. |
|
Компонент не установлен. См. заметки. |
|
Один из параметров функции недопустим. |
|
Компонент устанавливается локально. |
|
Предоставленный буфер был слишком мал. |
|
Компонент устанавливается для запуска из источника. |
|
Источник компонента недоступен. |
|
Код продукта или идентификатор компонента неизвестен. См. заметки. |
Комментарии
Функция MsiLocateComponent может возвращать INSTALLSTATE_ABSENT или INSTALL_STATE_UNKNOWN по следующим причинам:
- INSTALLSTATE_ABSENT
Приложение не правильно убедилось, что компонент установлен, вызвав MsiUseFeature и, при необходимости, MsiConfigureFeature.
- INSTALLSTATE_UNKNOWN
Функция не опубликована. Приложение должно определить это ранее, вызвав MsiQueryFeatureState или MsiEnumFeatures. Приложение выполняет эти вызовы во время инициализации. Приложение должно использовать только функции, которые известны для публикации. Так как INSTALLSTATE_UNKNOWN должны были быть возвращены MsiUseFeature , либо MsiUseFeature не был вызван, либо его возвращаемое значение не было правильно проверено.
Примечание
Заголовок msi.h определяет MsiLocateComponent в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в статье Требования к установщику Windows Run-Time. |
| Целевая платформа | Windows |
| Header | msi.h |
| Библиотека | Msi.lib |
| DLL | Msi.dll |