Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
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.
LFNSetVolumeLabel
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
WORD LFNSetVolumeLabel(iDrive, lpLabel)
WORD iDrive;
LPSTR lpLabel;
 
The LFNSetVolumeLabel function sets the volume label of the drive specified
by the iDrive parameter.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
iDrive     Specifies a one-based drive number. The parameter is 1 for drive
           A, 2 for drive B, and so on.
 
lpLabel    Points to the buffer that contains the new volume label. The
           buffer length must be at least 12 bytes.
 
Return Value
 
The return value is one of the following values.
 
Value  Meaning
────────────────────────────────────────────────────────────────────────────
0      Success.
 
1      Invalid function.
 
2      File not found.
 
5      Access denied.
 
Comments
 
The export ordinal for this function is 111.
 
Support for this function is not critical, but is included for completeness.
A driver may return the value for returned value that is denied access so
users cannot affect network volume labels.
 
See Also
 
LFNGetVolumeLabel