Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains version information about a file. This information is language- and code page–independent.

Syntax 

typedef struct VS_FIXEDFILEINFO {
  DWORD 
dwSignature;
  DWORD 
dwStrucVersion;
  DWORD 
dwFileVersionMS;
  DWORD 
dwFileVersionLS;
  DWORD 
dwProductVersionMS;
  DWORD 
dwProductVersionLS;
  DWORD 
dwFileFlagsMask;
  DWORD 
dwFileFlags;
  DWORD 
dwFileOS;
  DWORD 
dwFileType;
  DWORD 
dwFileSubtype;
  DWORD 
dwFileDateMS;
  DWORD 
dwFileDateLS;
} VS_FIXEDFILEINFO;

Members

dwStrucVersion

Binary version number of this structure. The high-order word of this member contains the major version number, and the low-order word contains the minor version number.

dwFileVersionMS

Most significant 32 bits of the file's binary version number. This member is used with dwFileVersionLSto form a 64-bit value used for numeric comparisons.

dwFileVersionLS

Least significant 32 bits of the file's binary version number. This member is used with dwFileVersionMSto form a 64-bit value used for numeric comparisons.

dwProductVersionMS

Most significant 32 bits of the binary version number of the product with which this file was distributed. This member is used with dwProductVersionLSto form a 64-bit value used for numeric comparisons.

dwProductVersionLS

Least significant 32 bits of the binary version number of the product with which this file was distributed. This member is used with dwProductVersionMSto form a 64-bit value used for numeric comparisons.

dwFileFlagsMask

Bitmask that specifies the valid bits in dwFileFlags. A bit is valid only if it was defined when the file was created.

dwFileFlags

Bitmask that specifies the Boolean attributes of the file. The following table shows the possible flags for this member.

Flag Description

VS_FF_DEBUG

The file contains debugging information or is compiled with debugging features enabled.

VS_FF_INFOINFERRED

The file's version structure was created dynamically; therefore, some of the members in this structure may be empty or incorrect. This flag should never be set in a file's VS_VERSIONINFOdata.

VS_FF_PATCHED

The file has been modified and is not identical to the original shipping file of the same version number.

VS_FF_PRERELEASE

The file is a development version, not a commercially released product.

VS_FF_PRIVATEBUILD

The file was not built using standard release procedures. If this flag is set, the StringFileInfostructure should contain a PrivateBuildentry.

VS_FF_SPECIALBUILD

The file was built by the original company using standard release procedures but is a variation of the normal file of the same version number. If this flag is set, the StringFileInfostructure should contain a SpecialBuildentry.
dwFileOS

OS for which this file was designed. The following table shows the possible flags for this member.

Flag Description

VOS_DOS

The file was designed for MS-DOS.

VOS_NT

The file was designed for Windows NT and Windows 2000.

VOS_OS216

The file was designed for 16-bit OS/2.

VOS_OS232

The file was designed for 32-bit OS/2.

VOS__PM16

The file was designed for 16-bit Presentation Manager.

VOS_UNKNOWN

The OS for which the file was designed is unknown to the system.

VOS__WINDOWS16

The file was designed for 16-bit Windows.

VOS__WINDOWS32

The file was designed for the Win32 API.

An application can combine these values to indicate that the file was designed for one OS running on another. The following table shows the dwFileOSflags, but is not a complete list.

Flag Description

VOS_DOS_WINDOWS16

The file was designed for 16-bit Windows running on MS-DOS.

VOS_DOS_WINDOWS32

The file was designed for 32-bit Windows running on MS-DOS.

VOS_NT_WINDOWS32

The file was designed for Windows NT and Windows 2000.

VOS_OS216_PM16

The file was designed for 16-bit Presentation Manager running on 16-bit OS/2.

VOS_OS232_PM32

The file was designed for 32-bit Presentation Manager running on 32-bit OS/2.
dwFileType

General type of file. The following table shows the possible flags for this member.

Flag Description

VFT_UNKNOWN

The file type is unknown to the system.

VFT_APP

The file contains an application.

VFT_DLL

The file contains a DLL.

VFT_DRV

The file contains a device driver. If dwFileTypeis VFT_DRV, dwFileSubtypecontains a more specific description of the driver.

VFT_FONT

The file contains a font. If dwFileTypeis VFT_FONT, dwFileSubtypecontains a more specific description of the font file.

VFT_STATIC_LIB

The file contains a static-link library.

VFT_VXD

The file contains a virtual device.

All other values are reserved for future use by Microsoft.

dwFileSubtype

Function of the file. The possible values depend on the value of dwFileType. For all values of dwFileTypenot described in the following list, dwFileSubtypeis zero.

The following table shows that if dwFileType is VFT_DRV, dwFileSubtypecan be one of the following flags.

Flag Description

VFT2_DRV_COMM

The file contains a communications driver.

VFT2_DRV_DISPLAY

The file contains a display driver.

VFT2_DRV_INSTALLABLE

The file contains an installable driver.

VFT2_DRV_KEYBOARD

The file contains a keyboard driver.

VFT2_DRV_LANGUAGE

The file contains a language driver.

VFT2_DRV_MOUSE

The file contains a mouse driver.

VFT2_DRV_NETWORK

The file contains a network driver.

VFT2_DRV_PRINTER

The file contains a printer driver.

VFT2_DRV_SOUND

The file contains a sound driver.

VFT2_DRV_SYSTEM

The file contains a system driver.

VFT2_UNKNOWN

The driver type is unknown by the system.

The following table shows that if dwFileTypeis VFT_FONT, dwFileSubtypecan be one of the following flags.

Flag Description

VFT2_FONT_RASTER

The file contains a raster font.

VFT2_FONT_VECTOR

The file contains a vector font.

VFT2_FONT_TRUETYPE

The file contains a TrueType font.

VFT2_UNKNOWN

The font type is unknown by the system.

If dwFileTypeis VFT_VXD, dwFileSubtypecontains the virtual device identifier included in the virtual device control block.

All dwFileSubtypevalues not listed here are reserved for future use by Microsoft.

dwFileDateMS

Most significant 32 bits of the file's 64-bit binary creation date and time stamp.

dwFileDateLS

Least significant 32 bits of the file's 64-bit binary creation date and time stamp.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also