CFLib.org – Common Function Library Project

ShareName(drvPath)

Last updated July 19, 2001

author

Rob Brooks-Bilson

Version: 1 | Requires: CF5 | Library: FileSysLib

Description:
Returns the network share name for the specified drive. If the specified drive is not a network share, returns a blank string. 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 ShareName(TheDrive) IS "">
The #TheDrive# drive is not a network share.
<CFELSE>
The share name for the #TheDrive# drive is #ShareName(TheDrive)#
</CFIF>
</CFOUTPUT>

Parameters:

Name Description Required
drvPath Drive letter (c, c:, c:\) or network share (\\computer\share). Yes

Full UDF Source:

/**
 * Returns the network share 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 ShareName(drvPath)
{
  Var fso  = CreateObject("COM", "Scripting.FileSystemObject");
  Var drive = fso.GetDrive(drvPath);
  Return drive.ShareName;
}
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson