The Filename data type is a text string containing a file name or folder. By default, the file name is assumed to use short file name syntax; that is, eight-character name, period (.), and 3-character extension. A short file name must always be provided because the SHORTFILENAMES property may be set or the target volume for the installation may only support short file names.

To include a long file name with the short file name, separate it from the short file name with a vertical bar (|).

For example, the following two strings are valid:

• status.txt
• projec~1.txt|Project Status.txt

Short and long file names must not contain the following characters:

• backward slash (/)
• question mark (?)
• vertical bar (|)
• right angle bracket (>)
• left angle bracket (<)
• colon (:)
• forward slash (\)
• asterisk (*)
• quotation mark (")

In addition, short file names must not contain the following characters:

• plus sign (+)
• comma (,)
• semicolon (;)
• equals sign (=)
• left square bracket ([)
• right square bracket (])

No space is allowed preceding the vertical bar (|) separator for the short file name/long file name syntax. Short file names may not include a space, although a long file name may. A space can exist after the separator only if the long file name of the file name begins with the space. No full-path syntax is allowed.

Note  The format of the FileName column of the MsiEmbeddedUI table is like the format Filename data type except that the vertical bar (|) separator for the short file name/long file name syntax is not available.

Send comments about this topic to Microsoft

Build date: 8/13/2009