Функция MsiGetFileVersionA (msi.h)

Статья
11/20/2024

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.

Возвращаемое значение

Ценность	Значение
ERROR_SUCCESS	Успешное завершение.
ERROR_FILE_NOT_FOUND	Файл не существует.
ERROR_ACCESS_DENIED	Файл не может быть открыт для получения сведений о версии.
ERROR_FILE_INVALID	Файл не содержит сведений о версии.
ERROR_INVALID_DATA	Недопустимые сведения о версии.
E_FAIL	Непредвиденная ошибка.

Замечания

Заметка

Заголовок 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

функции состояния системы

Поделиться через