Function GetLongPath

Src/paths.cpp:200–298

* Convert path to canonical long path. * This function converts given path to canonical long form. For example * foldenames with ~ short names are expanded. Also environment strings are * expanded if @p bExpandEnvs is true. If path does not exist, make canonical * the part that does exist, and leave the rest as is. Result, if a directory, * usually does not have a trailing backslash. * @para

 * @return Converted path.
 */
String GetLongPath(const String& szPath, bool bExpandEnvs)
{
	String sPath = szPath;
	size_t len = sPath.length();
	if (len < 1)
		return sPath;

	tchar_t fullPath[MAX_PATH_FULL] = {0};
	tchar_t *pFullPath = &fullPath[0];
	tchar_t *lpPart;

	//                                         GetFullPathName  GetLongPathName
	// Convert to fully qualified form              Yes               No
	//    (Including .)
	// Convert /, //, \/, ... to \                  Yes               No
	// Handle ., .., ..\..\..                       Yes               No
	// Convert 8.3 names to long names              No                Yes
	// Fail when file/directory does not exist      No                Yes
	//
	// Fully qualify/normalize name using GetFullPathName.

	// Expand environment variables:
	// Convert "%userprofile%\My Documents" to "C:\Documents and Settings\username\My Documents"
	tchar_t expandedPath[MAX_PATH_FULL];
	const tchar_t *lpcszPath = sPath.c_str();
	if (bExpandEnvs && tc::tcschr(lpcszPath, '%') != nullptr)
	{
		DWORD dwLen = ExpandEnvironmentStrings(lpcszPath, expandedPath, MAX_PATH_FULL);
		if (dwLen > 0 && dwLen < MAX_PATH_FULL)
			lpcszPath = expandedPath;
	}
	
	String tPath = TFile(String(lpcszPath)).wpath();
	DWORD dwLen = GetFullPathName(tPath.c_str(), MAX_PATH_FULL, pFullPath, &lpPart);
	if (dwLen == 0 || dwLen >= MAX_PATH_FULL)
		tc::tcslcpy(pFullPath, MAX_PATH_FULL, tPath.c_str());

	// We are done if this is not a short name.
	if (tc::tcschr(pFullPath, _T('~')) == nullptr)
		return pFullPath;

	// We have to do it the hard way because GetLongPathName is not
	// available on Win9x and some WinNT 4

	// The file/directory does not exist, use as much long name as we can
	// and leave the invalid stuff at the end.
	String sLong;
	tchar_t *ptr = pFullPath;
	tchar_t *end = nullptr;

	// Skip to \ position     d:\abcd or \\host\share\abcd
	// indicated by ^           ^                    ^
	if (tc::tcslen(ptr) > 2)
		end = tc::tcschr(pFullPath+2, _T('\\'));
	if (end != nullptr && !tc::tcsncmp(pFullPath, _T("\\\\"),2))
		end = tc::tcschr(end+1, _T('\\'));

	if (end == nullptr)