WindowsAPI之GetFileVersionInfo函数和VerQueryValue函数

最新推荐文章于 2024-10-11 12:55:02 发布

必胜虾

最新推荐文章于 2024-10-11 12:55:02 发布

阅读量8.6k

点赞数 3

分类专栏： WindowsAPI

WindowsAPI 专栏收录该内容

6 篇文章 1 订阅

订阅专栏

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;  
}