Функция GetFileVersionInfoExA (winver.h)

Статья
03/11/2023

Извлекает сведения о версии для указанного файла.

Синтаксис

BOOL GetFileVersionInfoExA(
  [in]  DWORD  dwFlags,
  [in]  LPCSTR lpwstrFilename,
        DWORD  dwHandle,
  [in]  DWORD  dwLen,
  [out] LPVOID lpData
);

Параметры

[in] dwFlags

Тип: DWORD

Управляет библиотеками DLL MUI (при наличии), из которых извлекается ресурс версии. Значение этого флага должно соответствовать флагам, переданным в соответствующий вызов GetFileVersionInfoSizeEx , который использовался для определения размера буфера, передаваемого в параметре dwLen . Ноль или несколько из следующих флагов.

Значение	Значение
FILE_VER_GET_LOCALISED 0x01	Загружает весь ресурс версии (строки и двоичные сведения о версии) из соответствующего многоязыкового интерфейса пользователя, если он доступен.
FILE_VER_GET_NEUTRAL 0x02	Загружает строки ресурсов версии из соответствующего многоязыкового интерфейса пользователя , если они доступны, а также двоичные сведения о версии (VS_FIXEDFILEINFO) из соответствующего файла, не зависящий от языка, если он доступен.
FILE_VER_GET_PREFETCHED 0x04	Указывает, что version.dll пытаться предварительно загрузить образ за пределами блокировки загрузчика, чтобы избежать конфликтов. Этот флаг не изменяет поведение или семантику функции.

[in] lpwstrFilename

Тип: LPCTSTR

Имя файла. Если полный путь не указан, функция использует последовательность поиска, указанную функцией LoadLibrary .

dwHandle

Тип: DWORD

Этот параметр зарезервирован и должен быть равен нулю (0).

[in] dwLen

Тип: DWORD

Размер (в байтах) буфера, на который указывает параметр lpData .

Сначала вызовите функцию GetFileVersionInfoSizeEx , чтобы определить размер в байтах сведений о версии файла. Параметр dwLen должен быть равен или больше этого значения.

Если буфер, на который указывает lpData , недостаточно велик, функция усекает сведения о версии файла до размера буфера.

[out] lpData

Тип: LPVOID

При возврате этой функции содержит указатель на буфер, содержащий сведения о версии файла.

Это значение можно использовать в последующем вызове функции VerQueryValue для получения данных из буфера.

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

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Заголовок winver.h определяет GetFileVersionInfoEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winver.h (включая Windows.h)
Библиотека	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll