dos12.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.
DosSetFSInfo (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSFILEMGR
 
USHORT DosSetFSInfo(usDriveNumber, usInfoLevel, pbBuf, cbBuf)
USHORT usDriveNumber; /* drive number                                     */
USHORT usInfoLevel;   /* level of file-system information                 */
PBYTE pbBuf;          /* pointer to structure for file-system information */
USHORT cbBuf;         /* length of buffer for file-system information     */
 
The DosSetFSInfo function sets file-system information. Currently it can
only be used to set the volume label of a disk.
 
The DosSetFSInfo function is a family API function.
 
Parameter      Description
────────────────────────────────────────────────────────────────────────────
 
usDriveNumber  Specifies the logical drive number. The usDriveNumber
               parameter must be a value from 0 through 26. The default
               drive is 0, drive A is 1, drive B is 2, and so on.
 
usInfoLevel    Specifies the level of file information to set. Currently,
               the only value that may be specified is FSIL_VOLSER.
 
pbBuf          Points to the structure that contains the information to set.
               When the usInfoLevel parameter is FSIL_VOLSER, the pbBuf
               parameter points to a VOLUMELABEL stucture.
 
cbBuf          Specifies the length (in bytes) of the structure pointed to
               by the pbBuf parameter.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_CANNOT_MAKE
     ERROR_INSUFFICIENT_BUFFER
     ERROR_INVALID_DRIVE
     ERROR_INVALID_LEVEL
     ERROR_INVALID_NAME
     ERROR_LABEL_TOO_LONG
 
See Also
 
DosQCurDisk, DosQFSInfo, VOLUMELABEL