EXT Win Library - version

The win::version class provides simple access to version informations of executables. It loads version numbers and predefined strings.

Interface:


            class win::version {

                public:

                    const unsigned short major;

                    const unsigned short minor;

                    const unsigned short release;

                    const unsigned short build;

            

                    const std::wstring comments;

                    const std::wstring description;

                    const std::wstring ver;

                    const std::wstring name;

                    const std::wstring copyright;

                    const std::wstring trademarks;

                    const std::wstring filename;

                    const std::wstring product;

                    const std::wstring product_version;

            

                public:

                   
            version (const std::wstring & = L"", unsigned int = 0);


            

                private:

                    version (const version &);

                    version * operator = (const version &);

            };

win::version::version (const std::wstring &, unsigned int langid = 0)
Initializes all members of the structure to available values or ends with an exception. A first parameter to the constructor specifies name of the executable or DLL to retrieve the data from. When not used (or empty string), a current process module is assumed. The second, optional, parameter is the prefered language of the informations to load.
win::version::major
win::version::minor
win::version::release
win::version::build
A version numbers of the executable (or DLL).
win::version::comments
win::version::description
win::version::ver
win::version::name
win::version::copyright
win::version::trademarks
win::version::filename
win::version::product
win::version::product_version
Convenient predefined strings to describe the product and its manufacturer. See MSDN (Platform SDK documentation) for details.

The win::version object cannot be copied.

Details:

On failure, the std::runtime_error is thrown during construction of the object. The exception contains a short description of the problem. Also, the constructor may throw std::bad_alloc in case of internal allocations failure.

You will need to include "ext/win_bits/version.cpp" into your project in order to use win::version. Also the version.dll and psapi.dll must be linked to.

The lookup algorithm tries to access localized versions of the version information table in the following order:

The language specified by the identifier (second constructor parameter)
The user default language
The system default language
The neutral language (LANG_NEUTRAL)
The english language (LANG_ENGLISH)
The first language version available

Examples:


            #include <ext/win>

            

            int main () {

                win::version app_info;

            

                std::wprintf (L"Initializing %s version %s (%u.%u) ...\n",

                             
            app_info.product.c_str (), app_info.ver.c_str (),

                             
            app_info.product.major, app_info.product.minor);

            

                // ...

            

                return 0;

            };

Remarks

None.

[index]