CFLib.org – SetVolumeName

SetVolumeName(drvPath, newName)

Last updated August 2, 2001

author

Version: 1 | Requires: ColdFusion 5 | Library: FileSysLib

Rated 0 time(s). Average Rating: 0

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:

view plain print about

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.

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:

Name	Description	Required
drvPath	Drive letter (c, c:, c:\) or network share (\\computer\share).	Yes
newName	New volume name for the drive.	Yes

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<cfscript>
/**
 * 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 (&#114;&#98;&#105;&#108;&#115;&#64;&#97;&#109;&#107;&#111;&#114;&#46;&#99;&#111;&#109;) 
 * @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;
}
</cfscript>
		<cfscript>
/**
 * 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;
}
</cfscript>