Функция GetFileVersionInfoSizeA (winver.h)
Определяет, может ли операционная система получать сведения о версии указанного файла. Если сведения о версии доступны, 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winver.h (включая Windows.h) |
| Библиотека | Version.lib |
| DLL | Api-ms-win-core-version-l1-1-0.dll |
См. также раздел
Основные понятия
Справочные материалы