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

Статья
03/13/2024

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

Синтаксис

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

Параметры

[in] dwFlags

Тип: DWORD

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

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

[in] lpwstrFilename

Тип: LPCTSTR

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

dwHandle

Тип: DWORD

Этот параметр не учитывается.

[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