Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
WORD LFNParse(lpFile, lpMask, lpResult)
LPSTR lpFile;
LSPTR lpMask;
LPSTR lpResult;
 
The LFNParse function parses a long filename.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
lpFile     Points to a null-terminated string specifying the path to parse.
           The path can consist of long names, or a combination of both
           standard and long filenaming conventions.
 
lpMask     Points to null-terminated string specifying one or more
           components of a full path. The function uses these components as
           substitutes when forming the resulting path. Furthermore, if the
           last component of the lpMask parameter contains wildcards, the
           wildcards are combined with the filename component of the lpFile
           parameter to produce the resulting filename. If lpMask is NULL,
           the full path is copied to the lpResult parameter without
           substitution.
 
lpResult   Points to the buffer to receive the resulting path. If the
           lpResult parameter is NULL, the function returns the resulting
           path type but does not copy the path itself.
 
Return Value
 
The function returns one of the following values.
 
Value  Meaning
────────────────────────────────────────────────────────────────────────────
0      All components of the fully qualified path, including filename,
       conform to the MS-DOS standard filename specification. This means the
       file is accessible by MS-DOS and Windows applications.
 
1      The path conforms to the MS-DOS standard filename specification
       except for case.
 
2      The filename is a long filename.
 
Comments
 
The export ordinal for this function is 112.
 
The return value is 1 when a user types MS-DOS standard filenames in
lowercase. In general, these names should be mapped to uppercase unless
explicitly quoted.
 
                                      ♦