《Windows API巡礼》---GetFileVersionInfo函数和VerQueryValue函数

2024-04-24 22:32
文章标签 函数 windows api 巡礼 getfileversioninfo verqueryvalue

本文主要是介绍《Windows API巡礼》---GetFileVersionInfo函数和VerQueryValue函数，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

VS_FIXEDFILEINFO结构包含了文件的版本信息：

  1. typedef struct tagVS_FIXEDFILEINFO {  
  2.   DWORD dwSignature; //包含的值是0xFEEF04BD   
  3.   DWORD dwStrucVersion; //该结构的32位二进制版本号，高16位是主版本号，低16位是副版本号   
  4.   DWORD dwFileVersionMS; //该文件二进制版本号的高32bits   
  5.   DWORD dwFileVersionLS; //该文件二进制版本号的低32bits   
  6.   DWORD dwProductVersionMS; //发布该文件的产品二进制版本号高32bits   
  7.   DWORD dwProductVersionLS; //发布该文件的产品二进制版本号低32bits   
  8.   DWORD dwFileFlagsMask; //比特掩码，标志dwFileFlags的有效位   
  9.   DWORD dwFileFlags; //VS_FF_DEBUG---该文件包含调试信息或是由调试版编译的   
  10.                              //VS_FF_INFOINFERRED---文件的版本结构是动态创建的，   
  11. //因此，该结构中有的成员是空的或不正确的   
  12.                              //VS_FF_PATCHED---该文件被修改过   
  13.                              //VS_FF_PRERELEASE---该文件是开发版，不是商业发布版   
  14.                              //VS_FF_PRIVATEBUILD---该文件不是由标准发布步骤构建的   
  15.                              //VS_FF_SPECIALBUILD---该文件是由标准发布步骤构建的，   
  16. //但是相同版本号文件的变种   
  17.   DWORD dwFileOS; //该文件设计用于的操作系统   
  18.   DWORD dwFileType; //文件类型：VFT_APP---文件包含一个应用程序   
  19.                                            VFT_DLL---文件包含一个DLL  
  20.                                            VFT_DRV---文件包含一个设备驱动  
  21.                                            VFT_FONT---文件包含一个字体文件  
  22.                                            VFT_STATIC_LIB---文件包含一个静态链接库  
  23.                                            VFT_UNKNOWN---文件类型未知  
  24.                                            VFT_VXD---文件包含一个虚拟设备  
  25.   DWORD dwFileSubtype; //文件的子类型，由dwFileType决定   
  26.   DWORD dwFileDateMS; //二进制文件创建日期和时间戳的高32bits   
  27.   DWORD dwFileDateLS; //二进制文件创建日期和时间戳的低32bits   
  28. } VS_FIXEDFILEINFO;  

GetFileVersionInfoSize函数用于判断系统能否检索到指定文件的版本信息，如果可以，函数返回版本信息的字节大小：

  1. DWORD WINAPI GetFileVersionInfoSize(  
  2.   __in       LPCTSTR lptstrFilename, //指定文件的名称   
  3.   __out_opt  LPDWORD lpdwHandle //一个变量的指针，该函数将该变量设为0   
  4. );  

GetFileVersionInfo函数用来获得指定文件的版本信息：

  1. BOOL WINAPI GetFileVersionInfo(  
  2.   __in        LPCTSTR lptstrFilename, //文件名   
  3.   __reserved  DWORD dwHandle, //保留值   
  4.   __in        DWORD dwLen, //lpData指向缓冲区的大小，使用函数GetFileVersionInfoSize得到   
  5.   __out       LPVOID lpData //指向存放文件版本信息的缓冲区的指针   
  6. );  

VerQueryValue函数用于从指定的版本信息源获取版本信息，在调用该函数之前，需要先依次调用函数GetFileVersionInfoSize和GetFileVersionInfo：

上面参数lpSubBlock取值中的string-name必须是下面系统预定义的字符串之一：

下面代码实例封装了一个文件版本信息类，使用上面介绍的函数方便地获取文件版本信息，头文件定义如下FileVersion.h： 

  1. // FileVersion.h: interface for the CFileVersion class.   
  2. // by Manuel Laflamme   
  3. //   
  4. #ifndef __FILEVERSION_H_   
  5. #define __FILEVERSION_H_   
  6. #if _MSC_VER >= 1000   
  7. #pragma once   
  8. #endif // _MSC_VER >= 1000   
  9. class CFileVersion  
  10. {   
  11. // Construction   
  12. public:   
  13.     CFileVersion();  
  14. // Operations      
  15. public:   
  16.     BOOL    Open(LPCTSTR lpszModuleName);  
  17.     void    Close();  
  18.     CString QueryValue(LPCTSTR lpszValueName, DWORD dwLangCharset = 0);  
  19.     CString GetFileDescription()  {return QueryValue(_T("FileDescription")); };  
  20.     CString GetFileVersion()      {return QueryValue(_T("FileVersion"));     };  
  21.     CString GetInternalName()     {return QueryValue(_T("InternalName"));    };  
  22.     CString GetCompanyName()      {return QueryValue(_T("CompanyName"));     };   
  23.     CString GetLegalCopyright()   {return QueryValue(_T("LegalCopyright"));  };  
  24.     CString GetOriginalFilename() {return QueryValue(_T("OriginalFilename"));};  
  25.     CString GetProductName()      {return QueryValue(_T("ProductName"));     };  
  26.     CString GetProductVersion()   {return QueryValue(_T("ProductVersion"));  };  
  27.     BOOL    GetFixedInfo(VS_FIXEDFILEINFO& vsffi);  
  28.     CString GetFixedFileVersion();  
  29.     CString GetFixedProductVersion();  
  30. // Attributes   
  31. protected:  
  32.     LPBYTE  m_lpVersionData;   
  33.     DWORD   m_dwLangCharset;   
  34. // Implementation   
  35. public:  
  36.     ~CFileVersion();   
  37. };   
  38. #endif  // __FILEVERSION_H_  

头文件的实现如下FileVersion.cpp：

  1. // FileVersion.cpp: implementation of the CFileVersion class.   
  2. // by Manuel Laflamme    
  3. //   
  4. #include "FileVersion.h"   
  5. #pragma comment(lib, "version")   
  6. #ifdef _DEBUG   
  7. #undef THIS_FILE   
  8. static char THIS_FILE[]=__FILE__;  
  9. #define new DEBUG_NEW   
  10. #endif   
  11. //   
  12. CFileVersion::CFileVersion()   
  13. {   
  14.     m_lpVersionData = NULL;  
  15.     m_dwLangCharset = 0;  
  16. }  
  17. CFileVersion::~CFileVersion()   
  18. {   
  19.     Close();  
  20. }   
  21. void CFileVersion::Close()  
  22. {  
  23.     delete[] m_lpVersionData;   
  24.     m_lpVersionData = NULL;  
  25.     m_dwLangCharset = 0;  
  26. }  
  27. BOOL CFileVersion::Open(LPCTSTR lpszModuleName)  
  28. {  
  29.     ASSERT(_tcslen(lpszModuleName) > 0);  
  30.     ASSERT(m_lpVersionData == NULL);  
  31.     // Get the version information size for allocate the buffer   
  32.     DWORD dwHandle;       
  33.     DWORD dwDataSize = ::GetFileVersionInfoSize((LPTSTR)lpszModuleName, &dwHandle);   
  34.     if ( dwDataSize == 0 )   
  35.         return FALSE;  
  36.     // Allocate buffer and retrieve version information   
  37.     m_lpVersionData = new BYTE[dwDataSize];   
  38.     if (!::GetFileVersionInfo((LPTSTR)lpszModuleName, dwHandle, dwDataSize,   
  39.                               (void**)m_lpVersionData) )  
  40.     {  
  41.         Close();  
  42.         return FALSE;  
  43.     }  
  44.     // Retrieve the first language and character-set identifier   
  45.     UINT nQuerySize;  
  46.     DWORD* pTransTable;  
  47.     if (!::VerQueryValue(m_lpVersionData, _T("\\VarFileInfo\\Translation"),  
  48.                          (void **)&pTransTable, &nQuerySize) )  
  49.     {  
  50.         Close();  
  51.         return FALSE;  
  52.     }  
  53.     // Swap the words to have lang-charset in the correct format   
  54.     m_dwLangCharset = MAKELONG(HIWORD(pTransTable[0]), LOWORD(pTransTable[0]));  
  55.     return TRUE;  
  56. }  
  57. CString CFileVersion::QueryValue(LPCTSTR lpszValueName,   
  58.                                  DWORD dwLangCharset /* = 0*/)  
  59. {  
  60.     // Must call Open() first   
  61.     ASSERT(m_lpVersionData != NULL);  
  62.     if ( m_lpVersionData == NULL )  
  63.         return (CString)_T("");  
  64.     // If no lang-charset specified use default   
  65.     if ( dwLangCharset == 0 )  
  66.         dwLangCharset = m_dwLangCharset;  
  67.     // Query version information value   
  68.     UINT nQuerySize;  
  69.     LPVOID lpData;  
  70.     CString strValue, strBlockName;  
  71.     strBlockName.Format(_T("\\StringFileInfo\\%08lx\\%s"),   
  72.                          dwLangCharset, lpszValueName);  
  73.     if ( ::VerQueryValue((void **)m_lpVersionData, strBlockName.GetBuffer(0),   
  74.                          &lpData, &nQuerySize) )  
  75.         strValue = (LPCTSTR)lpData;  
  76.     strBlockName.ReleaseBuffer();  
  77.     return strValue;  
  78. }  
  79. BOOL CFileVersion::GetFixedInfo(VS_FIXEDFILEINFO& vsffi)  
  80. {  
  81.     // Must call Open() first   
  82.     ASSERT(m_lpVersionData != NULL);  
  83.     if ( m_lpVersionData == NULL )  
  84.         return FALSE;  
  85.     UINT nQuerySize;  
  86.     VS_FIXEDFILEINFO* pVsffi;  
  87.     if ( ::VerQueryValue((void **)m_lpVersionData, _T("//"),  
  88.                          (void**)&pVsffi, &nQuerySize) )  
  89.     {  
  90.         vsffi = *pVsffi;  
  91.         return TRUE;  
  92.     }  
  93.     return FALSE;  
  94. }  
  95. CString CFileVersion::GetFixedFileVersion()  
  96. {  
  97.     CString strVersion;  
  98.     VS_FIXEDFILEINFO vsffi;  
  99.     if ( GetFixedInfo(vsffi) )  
  100.     {  
  101.         strVersion.Format (_T("%u,%u,%u,%u"),HIWORD(vsffi.dwFileVersionMS),  
  102.             LOWORD(vsffi.dwFileVersionMS),  
  103.             HIWORD(vsffi.dwFileVersionLS),  
  104.             LOWORD(vsffi.dwFileVersionLS));  
  105.     }  
  106.     return strVersion;  
  107. }  
  108. CString CFileVersion::GetFixedProductVersion()  
  109. {  
  110.     CString strVersion;  
  111.     VS_FIXEDFILEINFO vsffi;  
  112.     if ( GetFixedInfo(vsffi) )  
  113.     {  
  114.         strVersion.Format (_T("%u,%u,%u,%u"), HIWORD(vsffi.dwProductVersionMS),  
  115.             LOWORD(vsffi.dwProductVersionMS),  
  116.             HIWORD(vsffi.dwProductVersionLS),  
  117.             LOWORD(vsffi.dwProductVersionLS));  
  118.     }  
  119.     return strVersion;  
  120. }  

这篇关于《Windows API巡礼》---GetFileVersionInfo函数和VerQueryValue函数的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/933017。

相关文章

javafx 如何将项目打包为 Windows 的可执行文件exe

javafx 如何将项目打包为 Windows 的可执行文件exe

《javafx如何将项目打包为Windows的可执行文件exe》文章介绍了三种将JavaFX项目打包为.exe文件的方法：方法1使用jpackage（适用于JDK14及以上版本）,方法2使用La... 目录方法 1：使用 jpackage（适用于 JDK 14 及更高版本）方法 2：使用 Launch4j（
阅读更多...
windows端python版本管理工具pyenv-win安装使用

windows端python版本管理工具pyenv-win安装使用

《windows端python版本管理工具pyenv-win安装使用》：本文主要介绍如何通过git方式下载和配置pyenv-win,包括下载、克隆仓库、配置环境变量等步骤,同时还详细介绍了如何使用... 目录pyenv-win 下载配置环境变量使用 pyenv-win 管理 python 版本一、安装 和
阅读更多...
Python使用pysmb库访问Windows共享文件夹的详细教程

Python使用pysmb库访问Windows共享文件夹的详细教程

《Python使用pysmb库访问Windows共享文件夹的详细教程》本教程旨在帮助您使用pysmb库,通过SMB（ServerMessageBlock）协议,轻松连接到Windows共享文件夹,并列... 目录前置条件步骤一：导入必要的模块步骤二：配置连接参数步骤三：实例化SMB连接对象并尝试连接步骤四：
阅读更多...
C++11的函数包装器std::function使用示例

C++11的函数包装器std::function使用示例

《C++11的函数包装器std::function使用示例》C++11引入的std::function是最常用的函数包装器,它可以存储任何可调用对象并提供统一的调用接口,以下是关于函数包装器的详细讲解... 目录一、std::function 的基本用法1. 基本语法二、如何使用 std::function
阅读更多...
hdu1171（母函数或多重背包）

hdu1171（母函数或多重背包）

题意：把物品分成两份，使得价值最接近 可以用背包，或者是母函数来解，母函数（1 + x^v+x^2v+.....+x^num*v）（1 + x^v+x^2v+.....+x^num*v）（1 + x^v+x^2v+.....+x^num*v） 其中指数为价值，每一项的数目为（该物品数+1）个 代码如下： #include<iostream>#include<algorithm>
阅读更多...
C++操作符重载实例(独立函数)

C++操作符重载实例(独立函数)

C++操作符重载实例，我们把坐标值CVector的加法进行重载，计算c3=c1+c2时，也就是计算x3=x1+x2，y3=y1+y2，今天我们以独立函数的方式重载操作符+（加号），以下是C++代码： c1802.cpp源代码： D:\YcjWork\CppTour>vim c1802.cpp #include <iostream>using namespace std;/*** 以独立函数
阅读更多...
函数式编程思想

函数式编程思想

我们经常会用到各种各样的编程思想，例如面向过程、面向对象。不过笔者在该博客简单介绍一下函数式编程思想. 如果对函数式编程思想进行概括，就是f(x) = na(x) , y=uf(x)…至于其他的编程思想，可能是y=a(x)+b(x)+c(x)…，也有可能是y=f(x)=f(x)/a + f(x)/b+f(x)/c… 面向过程的指令式编程 面向过程，简单理解就是y=a(x)+b(x)+c(x)
阅读更多...
在 Windows 上部署 gitblit

在 Windows 上部署 gitblit

在 Windows 上部署 gitblit 在 Windows 上部署 gitblit 缘起gitblit 是什么安装JDK部署 gitblit 下载 gitblit 并解压配置登录注册为 windows 服务 修改 installService.cmd 文件运行 installService.cmd运行 gitblitw.exe查看 services.msc 缘起
阅读更多...
Windows如何添加右键新建菜单

Windows如何添加右键新建菜单

Windows如何添加右键新建菜单 文章目录 Windows如何添加右键新建菜单实验环境缘起以新建`.md`文件为例第一步第二步第三步 总结 实验环境 Windows7 缘起 因为我习惯用 Markdown 格式写文本，每次新建一个.txt后都要手动修改为.md，真的麻烦。如何在右键新建菜单中添加.md选项呢？ 网上有很多方法，这些方法我都尝试了，要么太麻烦，要么不凑效
阅读更多...
【LabVIEW学习篇 - 21】：DLL与API的调用

【LabVIEW学习篇 - 21】：DLL与API的调用

文章目录 DLL与API调用DLLAPIDLL的调用 DLL与API调用 LabVIEW虽然已经足够强大，但不同的语言在不同领域都有着自己的优势，为了强强联合，LabVIEW提供了强大的外部程序接口能力，包括DLL、CIN(C语言接口)、ActiveX、.NET、MATLAB等等。通过DLL可以使用户很方便地调用C、C++、C#、VB等编程语言写的程序以及windows自带的大
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2