Функция MsiGetComponentPathExW (msi.h)
Функция MsiGetComponentPathEx возвращает полный путь к установленному компоненту. Если путь к ключу для компонента является разделом реестра, функция возвращает раздел реестра.
Эта функция расширяет существующую функцию MsiGetComponentPath , чтобы включить поиск компонентов в учетных записях пользователей и контекстах установки.
Синтаксис
INSTALLSTATE MsiGetComponentPathExW(
[in] LPCWSTR szProductCode,
[in] LPCWSTR szComponentCode,
[in, optional] LPCWSTR szUserSid,
[in, optional] MSIINSTALLCONTEXT dwContext,
[out, optional] LPWSTR lpOutPathBuffer,
[in, out, optional] LPDWORD pcchOutPathBuffer
);
Параметры
[in] szProductCode
Строковое значение, завершающееся значением NULL, указывающее GUID кода продукта приложения. Функция получает путь к установленным компонентам, используемым этим приложением.
[in] szComponentCode
Строковое значение, завершающееся значением NULL, указывающее GUID кода компонента. Функция получает путь к установленному компоненту с этим кодом компонента.
[in, optional] szUserSid
Строковое значение, завершающееся значением NULL, указывающее идентификатор безопасности (SID) для пользователя в системе. Функция получает пути к установленным компонентам приложений, установленных в учетных записях пользователей, определенных этим идентификатором безопасности. Специальная строка sid s-1-1-0 (Все) указывает всех пользователей в системе. Если этот параметр имеет значение NULL, функция получает путь к установленному компоненту только для текущего пользователя, выполнившего вход.
[in, optional] dwContext
Флаг, указывающий контекст установки. Функция получает пути к установленным компонентам приложений, установленных в указанном контексте установки. Этот параметр может быть сочетанием следующих значений.
[out, optional] lpOutPathBuffer
Строковое значение, получающее путь к компоненту. Этот параметр может принимать значение NULL. Если компонент является разделом реестра, корневые элементы реестра представляются числовым образом. Если это путь к подразделу реестра, в конце пути к ключу имеется обратная косая черта. Если это путь к разделу значения реестра, обратная косая черта в конце отсутствует. Например, путь к реестру в 32-разрядной операционной системе HKEY_CURRENT_USER\SOFTWARE\Microsoft возвращается как "01:\SOFTWARE\Microsoft". Корневые элементы реестра, возвращаемые в 32-разрядных операционных системах, определяются, как показано в следующей таблице.
| Root | Значение |
|---|---|
|
00 |
|
01 |
|
02 |
|
03 |
[in, out, optional] pcchOutPathBuffer
Указатель на расположение, которое получает размер буфера в TCHAR, на которое указывает параметр szPathBuf . Значение в этом расположении должно быть равно числу TCHAR в строке, включая завершающий символ NULL. Если размер буфера слишком мал, этот параметр получает длину строкового значения без включения завершающего символа NULL в счетчик.
Возвращаемое значение
Функция MsiGetComponentPathEx возвращает следующие значения.
| Значение | Значение |
|---|---|
|
Запрашиваемый компонент отключен на компьютере. |
|
Данные конфигурации повреждены. |
|
Компонент не установлен. |
|
Один из параметров функции недопустим. |
|
Компонент устанавливается локально. |
|
Компонент устанавливается для запуска из источника. |
|
Источник компонента недоступен. |
|
Код продукта или идентификатор компонента неизвестен. |
|
Компонент поврежден или частично отсутствует и требует восстановления. |
Комментарии
Функция MsiGetComponentPathEx может возвращать INSTALLSTATE_ABSENT или INSTALL_STATE_UNKNOWN по следующим причинам:
- INSTALLSTATE_ABSENT
Приложение не правильно убедилось, что компонент установлен, вызвав MsiUseFeature и, при необходимости, MsiConfigureFeature.
- INSTALLSTATE_UNKNOWN
Функция не опубликована. Приложение должно определить это ранее, вызвав MsiQueryFeatureState или MsiEnumFeatures. Приложение выполняет эти вызовы во время инициализации. Приложение должно использовать только функции, которые известны для публикации. Так как INSTALLSTATE_UNKNOWN должны были быть возвращены MsiUseFeature , либо MsiUseFeature не был вызван, либо его возвращаемое значение не было правильно проверено.
Примечание
Заголовок msi.h определяет MsiGetComponentPathEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Сведения о минимальном пакете обновления Windows, необходимом для версии установщика Windows, см. в статье Требования к установщику Windows Run-Time. |
| Целевая платформа | Windows |
| Header | msi.h |
| Библиотека | Msi.lib |
| DLL | Msi.dll |