AGETFILEVERSION( ) Function

  • Article

Creates an array containing information about files with Windows version resources such as .exe, .dll, and .fll files, or automation servers created in Visual FoxPro.

Note

For a Visual FoxPro automation server to have Windows version resources, you must specify a value for at least one item in the EXE Version dialog box. For more information, see EXE Version Dialog Box.

AGETFILEVERSION(ArrayName, cFileName)

Parameters

  • ArrayName
    Specifies the name of the array in which the file information is placed. If the array you specify doesn't exist, Visual FoxPro automatically creates the array. If the array exists and isn't large enough to contain the file information, Visual FoxPro automatically increases the size of the array. If the array is larger than necessary, Visual FoxPro truncates the array.

    The following table lists the contents of each element of the array.

    Element

    Contents

    1

    Comments

    2

    Company Name

    3

    File Description

    4

    File Version

    5

    Internal Name

    6

    Legal Copyright

    7

    Legal Trademarks

    8

    Original File Name

    9

    Private Build

    10

    Product Name

    11

    Product Version

    The format of this value is dependent on the version of Visual FoxPro. For details, see VERSION( ) Function.

    12

    Special Build

    13

    OLE Self Registration (contains "OLESelfRegister" if the file supports self-registration; otherwise contains the empty string)

    14

    Language (derived from the Translation Code)

    15

    Translation Code

    For example, you can use the following code to determine the Locale ID for the Visual FoxPro executable file:

    DIMENSION aFiles[1]
AGETFILEVERSION(aFiles,"VFP9.EXE")
? EVAL("0x"+LEFT(aFiles[15],4))
** Returns 1033 for US version

  • cFileName
    Specifies the name, and optionally the path, of the target file.

Return Value

Numeric. AGETFILEVERSION( ) returns the number of elements in the array. If the file you specify does not exist or does not contain Windows version resources, AGETFILEVERSION( ) returns zero, and the array, if already created, remains unchanged.

Remarks

AGETFILEVERSION( ) can be abbreviated to a minimum number of 5 characters.

See Also

Reference

ADIR( ) Function

DIR or DIRECTORY Command

GETFILE( ) Function

Other Resources

Functions

Language Reference (Visual FoxPro)