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

Статья
11/20/2024

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

Синтаксис

DWORD GetFileVersionInfoSizeA(
  [in]            LPCSTR  lptstrFilename,
  [out, optional] LPDWORD lpdwHandle
);

Параметры

[in] lptstrFilename

Тип: LPCTSTR

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

[out, optional] lpdwHandle

Тип: LPDWORD

Указатель на переменную, которую функция задает нулю.

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

Тип: DWORD

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

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

Замечания

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

Заметка

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

Требования

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