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

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

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

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

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

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

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

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

BOOL WINAPI VerQueryValue( __in LPCVOID pBlock, //由函数GetFileVersionInfo得到的版本信息源 __in LPCTSTR lpSubBlock, //“/”表示该函数获取VS_FIXEDFILEINFO结构信息 //为“/VarFileInfo/Translation”表示该函数获取文件的翻译表 //为“/StringFileInfo/lang-codepage/string-name”表示该函数获取文件的字符串信息 __out LPVOID *lplpBuffer, //返回指向pBlock指向的地址，当pBlock被释放时，该参数也被释放 __out PUINT puLen //lplpBuffer指向的数据的字节大小 );

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

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

// FileVersion.h: interface for the CFileVersion class. // by Manuel Laflamme // #ifndef __FILEVERSION_H_ #define __FILEVERSION_H_ #if _MSC_VER >= 1000 #pragma once #endif // _MSC_VER >= 1000 class CFileVersion { // Construction public: CFileVersion(); // Operations public: BOOL Open(LPCTSTR lpszModuleName); void Close(); CString QueryValue(LPCTSTR lpszValueName, DWORD dwLangCharset = 0); CString GetFileDescription() {return QueryValue(_T("FileDescription")); }; CString GetFileVersion() {return QueryValue(_T("FileVersion")); }; CString GetInternalName() {return QueryValue(_T("InternalName")); }; CString GetCompanyName() {return QueryValue(_T("CompanyName")); }; CString GetLegalCopyright() {return QueryValue(_T("LegalCopyright")); }; CString GetOriginalFilename() {return QueryValue(_T("OriginalFilename"));}; CString GetProductName() {return QueryValue(_T("ProductName")); }; CString GetProductVersion() {return QueryValue(_T("ProductVersion")); }; BOOL GetFixedInfo(VS_FIXEDFILEINFO& vsffi); CString GetFixedFileVersion(); CString GetFixedProductVersion(); // Attributes protected: LPBYTE m_lpVersionData; DWORD m_dwLangCharset; // Implementation public: ~CFileVersion(); }; #endif // __FILEVERSION_H_

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

// FileVersion.cpp: implementation of the CFileVersion class. // by Manuel Laflamme // #include "FileVersion.h" #pragma comment(lib, "version") #ifdef _DEBUG #undef THIS_FILE static char THIS_FILE[]=__FILE__; #define new DEBUG_NEW #endif // CFileVersion::CFileVersion() { m_lpVersionData = NULL; m_dwLangCharset = 0; } CFileVersion::~CFileVersion() { Close(); } void CFileVersion::Close() { delete[] m_lpVersionData; m_lpVersionData = NULL; m_dwLangCharset = 0; } BOOL CFileVersion::Open(LPCTSTR lpszModuleName) { ASSERT(_tcslen(lpszModuleName) > 0); ASSERT(m_lpVersionData == NULL); // Get the version information size for allocate the buffer DWORD dwHandle; DWORD dwDataSize = ::GetFileVersionInfoSize((LPTSTR)lpszModuleName, &dwHandle); if ( dwDataSize == 0 ) return FALSE; // Allocate buffer and retrieve version information m_lpVersionData = new BYTE[dwDataSize]; if (!::GetFileVersionInfo((LPTSTR)lpszModuleName, dwHandle, dwDataSize, (void**)m_lpVersionData) ) { Close(); return FALSE; } // Retrieve the first language and character-set identifier UINT nQuerySize; DWORD* pTransTable; if (!::VerQueryValue(m_lpVersionData, _T("//VarFileInfo//Translation"), (void **)&pTransTable, &nQuerySize) ) { Close(); return FALSE; } // Swap the words to have lang-charset in the correct format m_dwLangCharset = MAKELONG(HIWORD(pTransTable[0]), LOWORD(pTransTable[0])); return TRUE; } CString CFileVersion::QueryValue(LPCTSTR lpszValueName, DWORD dwLangCharset /* = 0*/) { // Must call Open() first ASSERT(m_lpVersionData != NULL); if ( m_lpVersionData == NULL ) return (CString)_T(""); // If no lang-charset specified use default if ( dwLangCharset == 0 ) dwLangCharset = m_dwLangCharset; // Query version information value UINT nQuerySize; LPVOID lpData; CString strValue, strBlockName; strBlockName.Format(_T("//StringFileInfo//%08lx//%s"), dwLangCharset, lpszValueName); if ( ::VerQueryValue((void **)m_lpVersionData, strBlockName.GetBuffer(0), &lpData, &nQuerySize) ) strValue = (LPCTSTR)lpData; strBlockName.ReleaseBuffer(); return strValue; } BOOL CFileVersion::GetFixedInfo(VS_FIXEDFILEINFO& vsffi) { // Must call Open() first ASSERT(m_lpVersionData != NULL); if ( m_lpVersionData == NULL ) return FALSE; UINT nQuerySize; VS_FIXEDFILEINFO* pVsffi; if ( ::VerQueryValue((void **)m_lpVersionData, _T("//"), (void**)&pVsffi, &nQuerySize) ) { vsffi = *pVsffi; return TRUE; } return FALSE; } CString CFileVersion::GetFixedFileVersion() { CString strVersion; VS_FIXEDFILEINFO vsffi; if ( GetFixedInfo(vsffi) ) { strVersion.Format (_T("%u,%u,%u,%u"),HIWORD(vsffi.dwFileVersionMS), LOWORD(vsffi.dwFileVersionMS), HIWORD(vsffi.dwFileVersionLS), LOWORD(vsffi.dwFileVersionLS)); } return strVersion; } CString CFileVersion::GetFixedProductVersion() { CString strVersion; VS_FIXEDFILEINFO vsffi; if ( GetFixedInfo(vsffi) ) { strVersion.Format (_T("%u,%u,%u,%u"), HIWORD(vsffi.dwProductVersionMS), LOWORD(vsffi.dwProductVersionMS), HIWORD(vsffi.dwProductVersionLS), LOWORD(vsffi.dwProductVersionLS)); } return strVersion; }