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

Статья
11/20/2024

Определяет, может ли операционная система получать сведения о версии для указанного файла. Если сведения о версии доступны, GetFileVersionInfoSizeEx возвращает размер в байтах этой информации.

Синтаксис

DWORD GetFileVersionInfoSizeExA(
  [in]            DWORD   dwFlags,
  [in]            LPCSTR  lpwstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Параметры

[in] dwFlags

Тип: DWORD

Определяет, какие библиотеки DLL muI (если таковые есть), из которых извлекается ресурс версии. Ноль или более следующих флагов.

Ценность	Значение
FILE_VER_GET_LOCALISED 0x01	Загружает весь ресурс версии (строки и сведения о двоичной версии) из соответствующего файла MUI, если он доступен.
FILE_VER_GET_NEUTRAL 0x002	Загружает строки ресурсов версии из соответствующего файла MUI, если он доступен, и загружает сведения о двоичной версии (VS_FIXEDFILEINFO) из соответствующего файла с нейтральным языком, если он доступен.

[in] lpwstrFilename

Тип: LPCTSTR

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

[out, optional] lpdwHandle

Тип: LPDWORD

Когда эта функция возвращается, содержит указатель на переменную, которая имеет значение нулю, так как эта функция задает ему значение нулю. Этот параметр существует по историческим причинам.

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

Тип: DWORD

Если функция выполнена успешно, возвращаемое значение имеет размер (в байтах) сведений о версии файла.

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

Замечания

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

Заметка

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

Требования

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