LFNParse

	WORD LFNParse(lpFile, lpMask, lpResult)
	LPSTR lpFile;
	LSPTR lpMask;
	LPSTR lpResult;

The LFNParse function parses a long filename.

Parameters

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.