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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] dwFlags

Тип: DWORD

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

Ценность	Значение
FILE_VER_GET_LOCALISED 0x01	Загружает весь ресурс версии (строки и сведения о двоичной версии) из соответствующего файла MUI, если он доступен.
FILE_VER_GET_NEUTRAL 0x02	Загружает строки ресурсов версии из соответствующего файла MUI, если он доступен, и загружает сведения о двоичной версии (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.

Замечания

Вызовите функцию GetFileVersionInfoSizeEx перед вызовом функции GetFileVersionInfoEx. Чтобы получить сведения из буфера сведений о версии файла, используйте функцию VerQueryValue.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	winver.h (включая Windows.h)
библиотеки	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll