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

Статья
03/04/2024

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

Синтаксис

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

Параметры

[in] dwFlags

Тип: DWORD

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

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

Значение

FILE_VER_GET_LOCALISED
0x01

Загружает весь ресурс версии (строки и сведения о двоичной версии) из соответствующего многоязыкового интерфейса пользователя, если он доступен.

FILE_VER_GET_NEUTRAL
0x002

Загружает строки ресурсов версии из соответствующего многоязыкового интерфейса пользователя (если доступно) и двоичные сведения о версии (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 [только классические приложения]
Целевая платформа	Windows
Header	winver.h (включая Windows.h)
Библиотека	Version.lib
DLL	Api-ms-win-core-version-l1-1-0.dll