Version Information

Version information makes it easier for applications to install files properly and enables setup programs to analyze files currently installed. The version-information resource contains the version number of the file, its intended operating system, and the original file name.

In This Section

Name Description
About Version Information Discusses the version information functions.
Using Version Information Discusses how to use the version information functions.
Version Information Reference Contains the API reference.

Version Information Functions

Name Description
GetFileVersionInfo Retrieves version information for the specified file.
GetFileVersionInfoEx Retrieves version information for the specified file.
GetFileVersionInfoSize Determines whether the operating system can retrieve version information for a specified file. If version information is available, GetFileVersionInfoSize returns the size, in bytes, of that information.
GetFileVersionInfoSizeEx Determines whether the operating system can retrieve version information for a specified file. If version information is available, GetFileVersionInfoSizeEx returns the size, in bytes, of that information.
VerFindFile Determines where to install a file based on whether it locates another version of the file in the system. The values VerFindFile returns in the specified buffers are used in a subsequent call to the VerInstallFile function.
VerInstallFile Installs the specified file based on information returned from the VerFindFile function. VerInstallFile decompresses the file, if necessary, assigns a unique filename, and checks for errors, such as outdated files.
VerLanguageName Retrieves a description string for the language associated with a specified binary Microsoft language identifier.
VerQueryValue Retrieves specified version information from the specified version-information resource. To retrieve the appropriate resource, before you call VerQueryValue, you must first call the GetFileVersionInfoSize function, and then the GetFileVersionInfo function.

Version Information Structures

Name Description
String Depicts the organization of data in a file-version resource. It contains a string that describes a specific aspect of a file, for example, a file's version, its copyright notices, or its trademarks.
StringFileInfo Depicts the organization of data in a file-version resource. It contains version information that can be displayed for a particular language and code page.
StringTable Depicts the organization of data in a file-version resource. It contains language and code page formatting information for the strings specified by the Children member. A code page is an ordered character set.
Var Depicts the organization of data in a file-version resource. It typically contains a list of language and code page identifier pairs that the version of the application or DLL supports.
VarFileInfo Depicts the organization of data in a file-version resource. It contains version information not dependent on a particular language and code page combination.
VS_FIXEDFILEINFO Contains version information about a file. This information is language and code page independent.
VS_VERSIONINFO Depicts the organization of data in a file-version resource. It is the root structure that contains all other file-version information structures.