Функция MsiGetFileVersionW (msi.h)
MsiGetFileVersion возвращает строку версии и строку языка в формате, который установщик ожидает найти в базе данных. Если вам нужны только сведения о версии, задайте для lpLangBuf и pcchLangBuf значение 0 (ноль). Если вам просто нужны сведения о языке, задайте для lpVersionBuf и pcchVersionBuf значение 0 (ноль).
Синтаксис
UINT MsiGetFileVersionW(
[in] LPCWSTR szFilePath,
[out] LPWSTR lpVersionBuf,
[in, out] LPDWORD pcchVersionBuf,
[out] LPWSTR lpLangBuf,
[in, out] LPDWORD pcchLangBuf
);
Параметры
[in] szFilePath
Указывает путь к файлу.
[out] lpVersionBuf
Возвращает версию файла.
Задайте значение 0 только для сведений о языке.
[in, out] pcchVersionBuf
Количество входных и конечных буферов в качестве числа TCHAR.
Задайте значение 0 (ноль) только для сведений о языке. На входных данных это полный размер буфера, включая пробел для завершающего символа NULL. Если переданный буфер слишком мал, возвращаемое число не включает завершающий символ NULL.
[out] lpLangBuf
Возвращает язык файла.
Задайте значение 0 (ноль) только для сведений о версии.
[in, out] pcchLangBuf
Количество входных и конечных буферов в качестве числа TCHAR.
Задайте значение 0 (ноль) только для сведений о версии. На входных данных это полный размер буфера, включая пробел для завершающего символа NULL. Если переданный буфер слишком мал, возвращаемое число не включает завершающий символ NULL.
Возвращаемое значение
| Значение | Значение |
|---|---|
|
Успешное завершение. |
|
Файл не существует. |
|
Невозможно открыть файл для получения сведений о версии. |
|
Файл не содержит сведения о версии. |
|
Недопустимые сведения о версии. |
|
Непредвиденная ошибка. |
Комментарии
Примечание
Заголовок msi.h определяет MsiGetFileVersion в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Установщик 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 |