Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
Long Filename Functions
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
The network driver can provide a variety of long-filename functions. The
long-filename functions give access to files with names that do not fit the
MS-DOS standard filename convention on network drives. These are the
following long filename functions.
 
Function           Description
────────────────────────────────────────────────────────────────────────────
LFNCopy            Copies a file.
 
LFNDelete          Deletes a file.
 
LFNFindClose       Ends the search for matching files.
 
LFNFindFirst       Searches for the first file with a matching name.
 
LFNFindNext        Searches for the next file with a matching name.
 
LFNGetAttributes   Retrieves file attributes.
 
LFNGetVolumeLabel  Retrieves the volume label.
 
LFNMKDir           Creates a directory.
 
LFNMove            Moves a file.
 
LFNParse           Parses paths.
 
LFNRMDir           Removes a directory.
 
LFNSetAttributes   Sets file attributes.
 
LFNSetVolumeLabel  Sets the volume label.
 
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 value 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.
 
 
                                      ♦