Click here to Skip to main content
11,925,851 members (59,858 online)
Click here to Skip to main content
Add your own
alternative version


60 bookmarked

Modification of Version Information Resources in Compiled Binaries

, 2 Nov 2006 CPOL
Rate this:
Please Sign up or sign in to vote.
This library provides an easy way to read, modify, and save version information resource(s) (RT_VERSION) in compiled executable modules (EXE, DLL, OCX, SCR etc.).


There are several good articles here about reading module version information (by shaman74 and Armen Hakobyan), also there are some about modifying RC files during the build process (by Srinivas Vaithianathan and gugulea).

But sometimes, one needs to modify the version information in a compiled executable(s) or DLL:

  • Change product name, company name, comments, etc. when deploying multiple products under different names (different skins, branding, resources) but same code;
  • Update DLL version numbers without having to modify dozens of RC files;
  • Modify a self-extractable archive's (simple installers) resources to reflect the product name and the version information of the contained application.


This library provides an easy way to read, modify, and save version information resource(s) (RT_VERSION) in compiled executable modules (EXE, DLL, OCX, SCR, etc.).

CVersionInfo vi(strModulePath);
//Initialize version information object, 
//load first RT_VERSION resource

// Set file version in both VS_FIXEDFILEINFO
// and in all string tables
// FileVersion string will be set
// to "4, 5, 0, 3" just like VS does
vi.SetFileVersion(4, 5, 0, 3, 
       TRUE /*Update StringTables*/);

// Alternatively, if you need to set
// non-numeric version number
// like use
// vi["FileVersion"] = ""

// Set Comments string
vi["Comments"] = "We will stick to C++";

// Save modified version information to module,
// resource id, and language
// that we CVersionInfo from

Classes exported from VerLibInfo

  • CVersionInfo - The main class; reads and writes complete version information resources to/from modules. Contains CStringFileInfo and VS_FIXEDFILEINFO. The VarFileInfo structure is not a part of this object, because it is basically computed data. When saving modified version information, proper VarFileInfo is calculated from the number of string tables and their language-codepage keys.
  • CStringFileInfo - The wrapper for the StringFileInfo structure (contains string tables for different translations of the version information).
  • CStringTable- The wrapper for the string-table structure (contains the actual name-value pairs).
  • CVersionInfoString - The wrapper for the string structure.

CVersionInfo reference

// Construction/Destruction
// Construct uninitialized empty
// version information object

// Construct object, populate structures
// from RT_VERSION resource of a given module
CVersionInfo(const CString& strModulePath, 
             LPCTSTR lpszResourceId = NULL /*Auto*/, 
             WORD wLangId = 0xFFFF /*Auto*/);
virtual ~CVersionInfo();

//Read version information from module
BOOL FromFile(const CString& strModulePath, 
     LPCTSTR lpszResourceId = NULL /*Auto*/, 
     WORD wLangId = 0xFFFF /*Auto*/);

//Save version information to module resource 
//(specify strModulePath, lpszResourceId & wLangId 
//to copy resource to different module, resource, language)
BOOL ToFile(const CString& strModulePath = "", 
     LPCTSTR lpszResourceId = NULL /*Auto*/, 
     WORD wLangId = 0xFFFF /*Auto*/);

//Quick save (saves to the same module, resource, 
//and language that it was loaded from)
BOOL Save();

//Resets (removes all string tables 
//and cleans fixed version info)
void Reset();

// Validates object (mostly used to verify 
//that version information was 
//successfully loaded from module)
BOOL IsValid() const;

// Get/Set the order of blocks 
//(Regular (TRUE) = StringFileInfo first, VarFileInfo 2nd)
BOOL GetInfoBlockOrder() const;
void SetInfoBlockOrder(BOOL bRegularStringsFirst);

// Get reference to CStringFileInfo 
const CStringFileInfo& GetStringFileInfo() const;
CStringFileInfo& GetStringFileInfo();

// Overloaded bracket operators allow 
//quick access to first string table in StringFileInfo r/w
const CString operator [] (const CString &strName) const;
CString &operator [] (const CString &strName);

// Get reference to VS_FIXEDFILEINFO
const VS_FIXEDFILEINFO& GetFixedFileInfo() const;

// SetFileVersion - Updates file version 
//in VS_FIXEDFILEINFO and in string tables 
//when bUpdateStringTables == TRUE
void SetFileVersion(WORD dwFileVersionMSHi, 
                    WORD dwFileVersionMSLo, 
                    WORD dwFileVersionLSHi, 
                    WORD dwFileVersionLSLo, 
                    BOOL bUpdateStringTables = TRUE);
void SetFileVersion(DWORD dwFileVersionMS, 
                    DWORD dwFileVersionLS, 
                    BOOL bUpdateStringTables = TRUE);

// SetProductVersion - Updates product version
// in VS_FIXEDFILEINFO and ALL string tables
// when bUpdateStringTables == TRUE
void SetProductVersion(WORD dwProductVersionMSHi, 
                       WORD dwProductVersionMSLo, 
                       WORD dwProductVersionLSHi, 
                       WORD dwProductVersionLSLo, 
                       BOOL bUpdateStringTables = TRUE);
void SetProductVersion(DWORD dwProductVersionMS, 
                       DWORD dwProductVersionLS, 
                       BOOL bUpdateStringTables = TRUE);

Sample usage

The attached file contains a sample project that utilizes the library (VerInfoLibTest). The test tool understands several command line parameters:

Test Application for Version Info Library
VerInfoLibTest.exe -system
Prints out version numbers of all DLLs in Windows system folder

VerInfoLibTest.exe -f <FileName>
Prints out version info string tables of a specified module

VerInfoLibTest.exe -u <FileName> <StringName> "<Value>"
Modifies the StringName value in the first String Table 
         in module version information

VerInfoLibTest.exe -u mydll.dll CompanyName "New company name"
VerInfoLibTest.exe -u mydll.dll Comments "Updated comment"
VerInfoLibTest.exe -f mydll.dll

The code for "-system":

WIN32_FIND_DATA FindFileData;
::GetSystemDirectory(szBuf, MAX_PATH);
CString strSystemFolder = szBuf;

hFind = FindFirstFile(strSystemFolder + "\\*.dll", &FindFileData);

    printf ("Invalid File Handle. " 
            "Get Last Error reports %d\n", 
            GetLastError ());
        CString strModulePath = strSystemFolder + 
                   "\\" + FindFileData.cFileName;

        const CVersionInfo vi(strModulePath);
        if (vi.IsValid())
    while (FindNextFile(hFind, &FindFileData));

The code for "-f <FileName>":

const CVersionInfo vi(strFilePath);
if (vi.IsValid())
    POSITION posTable = 
    while (posTable)
        const CStringTable &st = 
        _tprintf(_T("String table %s\n-----") 
        POSITION posString = st.GetFirstStringPosition();
        while (posString)
            const CVersionInfoString &vistr = 
            _tprintf(_T("%s=%s\n"), vistr.GetKey(), 
    _tprintf(_T("Failed to get module version") 
             _T(" information for %s\n"), strFilePath);

This will produce an output similar to:

           VerInfoLibTest.exe -f VerInfoLib.dll
String table 040904b0
CompanyName=Denis Zabavchik
FileDescription=VerInfoLib DLL
FileVersion=1, 0, 0, 1
LegalCopyright=Copyright (C) 2006
ProductName=VerInfoLib Dynamic Link Library
ProductVersion=1, 0, 0, 1

The code for updating a given string is very neat (-u <FileName> <StringName> "<Value>"):

if (!_tcscmp(argv[1], _T("-u")))
    // 2nd argument is the file path
    CString strFilePath(argv[2]);
    CVersionInfo vi(strFilePath);
    vi[argv[3]] = argv[4];


The code compiles and works in VC6 and 2005 (both MBCS and UNICODE are supported). MFC is used for the container classes, maps etc. The code can be easily ported to be used without MFC.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Denis Zabavchik
Software Developer (Senior)
Russian Federation Russian Federation
No Biography provided

You may also be interested in...

Comments and Discussions

QuestionChange file Icon Pin
vidur sharam15-Jul-14 23:44
membervidur sharam15-Jul-14 23:44 
QuestionFile Version ! help please Pin
wawada8-Aug-13 5:14
memberwawada8-Aug-13 5:14 
QuestionGood job! Pin
Denis Dwornitzak21-Mar-12 4:32
memberDenis Dwornitzak21-Mar-12 4:32 
GeneralSimple DLL version? Pin
Crusiatus Black10-Jun-11 4:41
memberCrusiatus Black10-Jun-11 4:41 
GeneralChange Language Pin
-273C15-Mar-11 13:42
member-273C15-Mar-11 13:42 
AnswerRe: Change Language Pin
-273C18-Mar-11 4:49
member-273C18-Mar-11 4:49 
GeneralSetVersion.exe Pin
Misutka24-May-09 1:19
memberMisutka24-May-09 1:19 
GeneralAssert failure! [modified] Pin
ehaerim23-Apr-09 11:21
memberehaerim23-Apr-09 11:21 
GeneralRe: Assert failure! Pin
Denis Zabavchik23-Apr-09 11:50
memberDenis Zabavchik23-Apr-09 11:50 
GeneralMissing a 'GetFixedFileVersion' and 'GetFixedProductVersion' Pin
gil_mo1-Dec-08 21:44
membergil_mo1-Dec-08 21:44 
News.NET Version Available Pin
dB.30-Jun-08 9:58
memberdB.30-Jun-08 9:58 
QuestionFile version number limits? Pin
mikeycoltrane10-Jan-08 16:14
membermikeycoltrane10-Jan-08 16:14 
GeneralRe: File version number limits? Pin
Denis Zabavchik10-Jan-08 18:01
memberDenis Zabavchik10-Jan-08 18:01 
AnswerRe: File version number limits? Pin
mikeycoltrane10-Jan-08 18:52
membermikeycoltrane10-Jan-08 18:52 
GeneralRe: File version number limits? [modified] Pin
Denis Zabavchik10-Jan-08 19:11
memberDenis Zabavchik10-Jan-08 19:11 
GeneralRe: File version number limits? Pin
mikeycoltrane10-Jan-08 19:17
membermikeycoltrane10-Jan-08 19:17 
GeneralPatching file version (for the sample code) Pin
dB.12-Sep-07 11:10
memberdB.12-Sep-07 11:10 
GeneralRe: Patching file version (for the sample code) Pin
Denis Zabavchik12-Sep-07 11:20
memberDenis Zabavchik12-Sep-07 11:20 
GeneralGet Error when rebuild project Pin
coldsun20-Aug-07 22:16
membercoldsun20-Aug-07 22:16 
GeneralInvalid binary produced Pin
Bernd Holz19-Mar-07 8:03
memberBernd Holz19-Mar-07 8:03 
GeneralRe: Invalid binary produced Pin
Denis Zabavchik19-Mar-07 8:12
memberDenis Zabavchik19-Mar-07 8:12 
GeneralRe: Invalid binary produced Pin
zandar the great31-Aug-07 10:10
memberzandar the great31-Aug-07 10:10 
GeneralRe: Invalid binary produced Pin
CharlieMcD3-Oct-07 7:55
memberCharlieMcD3-Oct-07 7:55 
Questionincorrect fileversion writing Pin
chrislong28-Mar-07 16:21
memberchrislong28-Mar-07 16:21 
AnswerRe: incorrect fileversion writing Pin
Denis Zabavchik8-Mar-07 19:00
memberDenis Zabavchik8-Mar-07 19:00 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.151126.1 | Last Updated 2 Nov 2006
Article Copyright 2006 by Denis Zabavchik
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid