Поделиться через


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

Определяет, может ли операционная система получать сведения о версии для указанного файла. Если сведения о версии доступны, 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) из соответствующего файла, не зависящий от языка, если он доступен.

[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

См. также раздел

Основные понятия

GetFileVersionInfoEx

GetFileVersionInfoSize

Справочные материалы

VS_VERSIONINFO

VerQueryValue

Сведения о версии