《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. );  
7. 
   

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_  
39. 
    

头文件的实现如下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. }