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