LFNSetVolumeLabel

  WORD LFNSetVolumeLabel(iDrive, lpLabel)    
  WORD iDrive;    
  LPSTR lpLabel;    

The LFNSetVolumeLabel function sets the volume label of the drive specified by the iDrive parameter.

Parameters

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