CFLib.org – Common Function Library Project

Description:
Returns 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 a string.

Example:

<CFSET TheDrive = "c">

<CFOUTPUT>
<CFIF GetVolumeName(TheDrive) IS "">
The #TheDrive# drive is unnamed.
<CFELSE>
The volume name for the #TheDrive# drive is #GetVolumeName(TheDrive)#.
</CFIF>
</CFOUTPUT>

Parameters:

Full UDF Source:

/**
 * Returns the volume name for the specified drive. (Windows only)
 * 
 * @param drvPath      Drive letter (c, c:, c:\) or network share (\\computer\share). 
 * @return Returns a string. 
 * @author Rob Brooks-Bilson (rbils@amkor.com) 
 * @version 1.0, July 19, 2001 
 */
function GetVolumeName(drvPath)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var drive = fso.GetDrive(drvPath);
  Return drive.VolumeName;
}