Click here to Skip to main content
Click here to Skip to main content

FileVersion - Retrieve file version information

, 17 May 2010
Rate this:
Please Sign up or sign in to vote.
Easily determine the version of a specified file or the version of the current process.

Introduction

Getting the version information of a file is useful in many cases. Maybe you want to check the version of a library before you load it, to ensure not loading an old one which can result in unexpected software behaviour. Or you simply want to display the current version of your application in the About-box. This class allows you to do that in a very easy way.

Background

I'm going to develop an application which detects problems with duplicated libraries. It should notify me if an old library has been loaded instead of the new one because of the "Library Search Order". This class provides me the basic requirements for that, like determining or comparing file versions.

There are similar articles on the CodeProject already. I developed my own class to get a lightweight way to determine file versions without storing other information like company name, description, etc..

Using the code

The following samples demonstrate how to use this class.

Get the version of the current process

CString        strFileVersion;
FileVersion    cFileVersion;

// Get formated file version
cFileVersion.GetFileVersion( L"Version: %i.%i", strFileVersion );

Useful to keep your About dialog up-to-date:

About Box

Get the version of a specified file

CString        strFileVersion;
FileVersion    cFileVersion( L"C:\\Windows\\System32\\NativeHooks.dll" );

// Get file version
cFileVersion.GetFileVersion( strFileVersion );

MessageBox( strFileVersion );

Output:

File version of NativeHooks.dll

Compare file versions

// Version is 6.1.7600.16385
FileVersion    cFileVersionNativeHooks( L"C:\\Windows\\System32\\NativeHooks.dll" );

// Version is 12.0.7600.16385
FileVersion    cFileVersionWmerror( L"C:\\Windows\\System32\\wmerror.dll" );

// Compare versions
bool bIsGreater =  ( cFileVersionNativeHooks > cFileVersionWmerror );  // false
bool bIsLess    =  ( cFileVersionNativeHooks < cFileVersionWmerror );  // true
bool bIsEqual    =  ( cFileVersionNativeHooks == cFileVersionWmerror ); // false

Interface

Constructors

  • explicit FileVersion( const TCHAR * kstrFilePath ): Creates the FileVersion of the specified file.
  • FileVersion() Creates the FileVersion: of the current process.

Methods

  • bool IsValid() const: Returns whether the file version could be determined.
  • unsigned short GetMajorVersion() const: Returns the Major Version.
  • unsigned short GetMinorVersion() const: Returns the Minor Version.
  • unsigned short GetReleaseNumber() const: Returns the Release Number.
  • unsigned short GetBuildNumber() const: Returns the Build Number.
  • bool GetFileVersion( const TCHAR* kstrFileFormat, CString& strFileVersion ) const: Gets the file version string. The order is Major, Minor, Release, and Build Number. The string can be formatted; for instance, L"Version: %i.%i.%i.%i" will return a string like "Version: 12.1.0.530".
  • bool GetFileVersion( CString& strFileVersion ) const: Gets the file version string. The order is Major, Minor, Release, and Build number, with a dot in between. For example: "12.1.0.530".
  • bool IsEqual( const FileVersion & krhs ) const: Returns true if the file version is equal to the passed file version.

Operations

  • bool operator<( const FileVersion & krhs ) const: Returns true if the file version is less than the passed file version.
  • bool operator>( const FileVersion & krhs ) const: Returns true if the file version is greater than the passed file version.
  • bool operator==( const FileVersion & krhs ) const: Returns true if the file version is equal to the passed file version.

Implementation details

This is how the file version is determined:

bool FileVersion::DetermineFileVersion( const TCHAR* kstrFilePath )
{
    // Precondition
    if ( NULL == kstrFilePath )
        return false; // FilePath is empty, no file to determine version.

    DWORD    dwHandle;

    // Determines whether the operating system can retrieve version information
    // for a specified file.
    DWORD    dwFileVersionInfoSize = 
        GetFileVersionInfoSize( kstrFilePath, &dwHandle );

    if ( NULL == dwFileVersionInfoSize )
        return false;    // Can't retrieve version information size.

    // Allocate space to retrieve version information using vector to prevent
    // memory leaks
    std::vector<BYTE>    pData( dwFileVersionInfoSize );

    // Retrieves version information for the specified file.
    if ( false == GetFileVersionInfo( kstrFilePath
        , dwHandle
        , dwFileVersionInfoSize
        , static_cast<lpvoid>( &pData[0] ) ) )
        return false; // Can't retrieve version information.

    // The memory of ptFileInfo is freed when pData is freed.
    VS_FIXEDFILEINFO *ptFileInfo;
    UINT    uintSize;

    // Retrieves version information from the version-information resource
    if ( false == VerQueryValue( static_cast<lpvoid>( &pData[0] )
        , _T("\\")
        , reinterpret_cast<lpvoid*> ( &ptFileInfo )
        , &uintSize ) )
        return false; // Can't retrieve version information

    // Resolve major, minor, release and build number.
    musMajorVersion        = static_cast<unsigned>(  
        ( ptFileInfo->dwFileVersionMS >> 16 ) &0xffff );

    musMinorVersion        = static_cast<unsigned>( 
        ptFileInfo->dwFileVersionMS &0xffff );

    musReleaseNumber    = static_cast<unsigned>( 
        ( ptFileInfo->dwFileVersionLS >> 16 ) &0xffff);

    musBuildNumber        = static_cast<unsigned>( 
        ptFileInfo->dwFileVersionLS & 0xffff );

    return true;
}

Notes

This class compiles with UNICODE and ANSI at warning level 4.

License

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

About the Author

Martin Brandl
Software Developer
Germany Germany
I study computer science, develop software in my free time.

Comments and Discussions

 
GeneralMy vote of 5 Pinmemberrbrunton14-May-11 3:02 
Generalincorrect usage of auto_ptr Pinmemberimagiro6-May-10 0:25 
GeneralRe: incorrect usage of auto_ptr [modified] PinmemberMartin Brandl6-May-10 0:37 
GeneralReally cool ! Pinmemberwellental5-May-10 23:19 
GeneralMy vote of 2 Pinmemberdgendreau5-May-10 17:28 
GeneralRe: My vote of 2 [modified] PinmemberMartin Brandl5-May-10 21:39 
GeneralRe: My vote of 2 [modified] Pinmemberdgendreau6-May-10 5:09 
GeneralRe: My vote of 2 [modified] Pinmemberdgendreau6-May-10 6:57 
GeneralRe: My vote of 2 PinmemberMartin Brandl6-May-10 7:17 
GeneralRe: My vote of 2 [modified] Pinmemberdgendreau6-May-10 7:36 
GeneralRe: My vote of 2 PinmemberMartin Brandl6-May-10 8:19 
GeneralAwesome one - 5 from me PinmentorKunalChowdhury5-May-10 5:55 
GeneralRe: Awesome one - 5 from me PinmemberMartin Brandl5-May-10 5:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    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 | Mobile
Web01 | 2.8.140721.1 | Last Updated 18 May 2010
Article Copyright 2010 by Martin Brandl
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid