1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef BASE_FILE_VERSION_INFO_H__
6 #define BASE_FILE_VERSION_INFO_H__
8 #include "build/build_config.h"
12 // http://blogs.msdn.com/oldnewthing/archive/2004/10/25/247180.aspx
13 extern "C" IMAGE_DOS_HEADER __ImageBase
;
18 #include "base/base_export.h"
19 #include "base/string16.h"
23 // Provides an interface for accessing the version information for a file. This
24 // is the information you access when you select a file in the Windows Explorer,
25 // right-click select Properties, then click the Version tab, and on the Mac
26 // when you select a file in the Finder and do a Get Info.
28 // This list of properties is straight out of Win32's VerQueryValue
29 // <http://msdn.microsoft.com/en-us/library/ms647464.aspx> and the Mac
30 // version returns values from the Info.plist as appropriate. TODO(avi): make
31 // this a less-obvious Windows-ism.
33 class FileVersionInfo
{
35 virtual ~FileVersionInfo() {}
36 #if defined(OS_WIN) || defined(OS_MACOSX)
37 // Creates a FileVersionInfo for the specified path. Returns NULL if something
38 // goes wrong (typically the file does not exit or cannot be opened). The
39 // returned object should be deleted when you are done with it.
40 BASE_EXPORT
static FileVersionInfo
* CreateFileVersionInfo(
41 const FilePath
& file_path
);
42 #endif // OS_WIN || OS_MACOSX
45 // Creates a FileVersionInfo for the specified module. Returns NULL in case
46 // of error. The returned object should be deleted when you are done with it.
47 BASE_EXPORT
static FileVersionInfo
* CreateFileVersionInfoForModule(
50 // Creates a FileVersionInfo for the current module. Returns NULL in case
51 // of error. The returned object should be deleted when you are done with it.
52 // This function should be inlined so that the "current module" is evaluated
53 // correctly, instead of being the module that contains base.
54 __forceinline
static FileVersionInfo
*
55 CreateFileVersionInfoForCurrentModule() {
56 HMODULE module
= reinterpret_cast<HMODULE
>(&__ImageBase
);
57 return CreateFileVersionInfoForModule(module
);
60 // Creates a FileVersionInfo for the current module. Returns NULL in case
61 // of error. The returned object should be deleted when you are done with it.
62 BASE_EXPORT
static FileVersionInfo
* CreateFileVersionInfoForCurrentModule();
65 // Accessors to the different version properties.
66 // Returns an empty string if the property is not found.
67 virtual string16
company_name() = 0;
68 virtual string16
company_short_name() = 0;
69 virtual string16
product_name() = 0;
70 virtual string16
product_short_name() = 0;
71 virtual string16
internal_name() = 0;
72 virtual string16
product_version() = 0;
73 virtual string16
private_build() = 0;
74 virtual string16
special_build() = 0;
75 virtual string16
comments() = 0;
76 virtual string16
original_filename() = 0;
77 virtual string16
file_description() = 0;
78 virtual string16
file_version() = 0;
79 virtual string16
legal_copyright() = 0;
80 virtual string16
legal_trademarks() = 0;
81 virtual string16
last_change() = 0;
82 virtual bool is_official_build() = 0;
85 #endif // BASE_FILE_VERSION_INFO_H__