3.7.8 Long Filename Interface

The Long Filename interface enables access to files with names that do not fit the MS-DOS standard filenaming convention on network drives. The following list outlines these functions, and provides a brief description of each.

Function Description

LFNFindFirst Searches for the first file with a matching name.
LFNFindNext Searches for the next file with a matching name.
LFNFindClose Ends the search for matching files.
LFNGetAttributes Retrieves file attributes.
LFNSetAttributes Sets file attributes.
LFNCopy Copies a file.
LFNMove Moves a file.
LFNDelete Deletes a file.
LFNMKDir Creates a directory.
LFNRMDir Removes a directory.
LFNGetVolumeLabel Retrieves the volume label.
LFNSetVolumeLabel Sets the volume label.
LFNParse Parses paths.
LFNVolumeType Specifies volume type.

Typically, these functions are called only when a network drive with long filenames is detected. In other words, they do not need to support local drives. The exception is the LFNCopy function which must be able to copy to or from any type of volume.

The return value is typically an MS-DOS error function (as returned from MS-DOS functions when the carry flag is set, or from Interrupt 21h Function 59h, Get Extended Error Information). If a function returns the special error code 0xFFFF, then the network error message functions will be called to retrieve error message text.

The maximum length of any long filename will be assumed to be 260 characters, including the terminator.

File-attribute values are identical to MS-DOS file-attribute fields.