VS_FIXEDFILEINFO (Compact 2013)

  • Article

3/28/2014

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 dwFileVersionLS to 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 dwFileVersionMS to 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 dwProductVersionLS to 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 dwProductVersionMS to 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_VERSIONINFO data.

    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 StringFileInfo structure should contain a PrivateBuild entry.

    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 StringFileInfo structure should contain a SpecialBuild entry.

  • 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 dwFileOS flags, 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 dwFileType is VFT_DRV, dwFileSubtype contains a more specific description of the driver.

    VFT_FONT

    The file contains a font. If dwFileType is VFT_FONT, dwFileSubtype contains 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.

  • dwFileSubtype
    Function of the file. The possible values depend on the value of dwFileType. For all values of dwFileType not described in the following list, dwFileSubtype is zero.

    The following table shows that if dwFileType is VFT_DRV, dwFileSubtype can 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 dwFileType is VFT_FONT, dwFileSubtype can 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 dwFileType is VFT_VXD, dwFileSubtype contains the virtual device identifier included in the virtual device control block.

    All dwFileSubtype values not listed here are reserved.

  • 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

See Also

Reference

System Management Structures
StringFileInfo
VS_VERSIONINFO

Other Resources

GetFileVersionInfo