Returns the long name of a file or directory.
// Retrieve the long name of a file
ResLongName = fLongName("C:\MyDir~1\Account~1.doc")
// fLongName returns "Status report for March 2001.doc"
Syntax
<Result> = fLongName(<File path> [, <Options>])
<Result>: Character string
- Long name of the file or directory. Only the long name of the file or directory is returned.
- Empty string ("") if an error occurred (file or directory not found). To get more details on the error, use ErrorInfo with the errMessage constant.
<File path>: Character string
Name and full (or relative) path of the file or directory (up to 260 characters). A UNC path can be used.
<Options>: Optional Integer constant
Used to specify the format of function result. By default, fLongName returns a character string in Ansi format. | |
fPathUNICODE | <Result> will be a Unicode string. |
Remark: The result of fLongName is always an ANSI character string, the fPathUNICODE constant is only used to store the result in a Unicode character string.
Remarks
Long names
fLongName returns:
- the long name of the file or directory if <File path> is expressed in short names (name with 8 characters or less, containing a "~").
- the name of the specified file if the name of the file in <File path> is:
- expressed as long name (name exceeding 8 characters),
- 8 characters long (or less) and does not contain a tilde ("~").
- the name of the specified directory if the name of the directory in <File path> is:
- expressed as long name (name exceeding 8 characters),
- 8 characters long (or less) and does not contain a tilde ("~").
Business / UI classification: Business Logic