CFLib.org – Common Function Library Project

Description:
Sets the volume name for the specified drive. Because this function uses COM, it is only supported in the Windows version of ColdFusion.

Return Values:
Returns True.

Example:

Because this function modifies the volume name of an actual drive on the server, no live example is provided.  For example code, see the header comments in the library.

Parameters:

Full UDF Source:

/**
 * Sets the volume name for the specified drive. (Windows only)
 * Sample code: 
 * <CFSET SetVolumeName("c", "System")>
 * 
 * @param drvPath      Drive letter (c, c:, c:\) or network share (\\computer\share). 
 * @param newName      New volume name for the drive. 
 * @return Returns True. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1, August 2, 2001 
 */
function SetVolumeName(drvPath, newName)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var drive = fso.GetDrive(drvPath);
  drive.VolumeName = newName;
  Return True;
}