Функция MsiGetFileVersionA (msi.h)
MsiGetFileVersion возвращает строку версии и строку языка в формате, который установщик ожидает найти в базе данных. Если вам нужны только сведения о версии, задайте для lpLangBuf и pcchLangBuf значение 0 (ноль). Если вам нужны только сведения о языке, задайте для lpVersionBuf и pcchVersionBuf значение 0 (ноль).
Синтаксис
UINT MsiGetFileVersionA(
[in] LPCSTR szFilePath,
[out] LPSTR lpVersionBuf,
[in, out] LPDWORD pcchVersionBuf,
[out] LPSTR 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 или Юникод этой функции на основе определения константы препроцессора 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 |