Windows maximum path length

Время на прочтение4 мин

Количество просмотров80K

Картинка с сайта: habr.com

Многим пользователям ПК под управлением ОС Windows, не говоря о разработчиках, знакомы проблемы при работе с длинными (более 260 символов, MAX_PATH) путями файлов или каталогов.

В данной статье рассматриваются способы избавления от этого пережитка при разработке приложений на различных платформах (WinApi, .Net Framework, .Net Core) и активации нативной поддержки длинных путей в Windows 10 (Anniversary Update).

Приложения Win API

В приложениях, которые используют Win API для работы с файлами, рецепт избавления от ограничения MAX_PATH был известен с незапамятных времён – необходимо было использовать Unicode версию функции с окончанием «W» для работы с директорией или файлом и начинать путь с префикса \\?\. Это давало возможность использовать пути длинной до 32767 символов.

В Windows 10 (1607) поведение функций для работы с файлами изменилось: появилась возможность отключить проверку ограничений MAX_PATH на уровне системы.

Это избавляет от необходимости использовать префикса \\?\ и потенциально даёт шанс приложениям, работающим напрямую или косвенно через Win API, получить поддержку длинных путей без необходимости их пересборки. Как активировать эту возможность описано в конце статьи.

.Net Framework

Хотя .Net Framework и использует Win API для работы с файлами — предыдущее изменение не принесло бы результата, т.к. в код BCL встроены предварительные проверки на допустимость длинны имён каталогов и файлов, и до вызова функций Win API дело даже не доходило, выдавая известное исключение. По многочисленным просьбам сообщества (более 4500 на UserVoice) в версии 4.6.2 из кода BCL вырезали проверки ограничения длинны пути, отдав это на откуп операционной и файловой системам!

Вот что это даёт:

• При использовании префикса “\\?\” мы можем работать с длинными путями как в Win API,

  Directory.CreateDirectory("\\\\?\\" + long_dir_name);

• Если активировать нативную поддержку длинных имен файлов Windows 10 (1607), то даже не потребуется использовать префикс!

Как включить:

• Использовать .Net Framework 4.6.2 как цель при сборке приложения.
• Использовать конфигурационный файл, например, если приложение уже было собрано под .Net 4.0:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
    </startup>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false;Switch.System.IO.BlockLongPaths=false" />
  </runtime>
</configuration>

.Net Core

Тут поддержку длинных путей анонсировали ещё в ноябре 2015 года. Видимо сказалось Open Source природа проекта и отсутствие строгой необходимости обеспечения обратной совместимости.

Как включить:
Всё работает из коробки. В отличие от реализации в .Net Framework – тут нет необходимости в добавлении префикса “\\?\” – он добавляется автоматически при необходимости.

Вот тут можно посмотреть пример.

Как включить поддержку длинных путей в Windows 10 (1607)

Эта возможность по умолчанию отключена. Это объясняется тем, что данная функция является экспериментальной, и имеется необходимость дорабатывать различные подсистемы и приложения для полной поддержки.

Включить встроенную поддержку длинных путей можно создав или изменив следующий параметр системного реестра: HKLM\SYSTEM\CurrentControlSet\Control\FileSystem Параметр LongPathsEnabled (Тип: REG_DWORD) 1 – соответствует значению включено.

Картинка с сайта: habr.com

Или через групповые политики (Win+R\gpedit.msc) Computer Configuration > Administrative Templates > System > Filesystem > Enable NTFS long paths.Оно же в локализованном варианте: Конфигурация компьютера > Административные шаблоны > Система > Файловая система > Включить длинные пути Win32.

Картинка с сайта: habr.com

Далее источники расходятся во мнении относительно манифеста (или я неправильно понял, но на данный момент проверить не имею возможности). Например, в документации MSDN написано, что манифест можно использовать в качестве альтернативного способа активации поддержки длинных путей в отдельных приложениях, а в блоге MSDN указано, что это является вторым обязательным шагом после активации в политиках.
Но они сходятся в формате задания данной опции:

<application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings xmlns:ws2="http://schemas.microsoft.com/SMI/2016/WindowsSettings">
        <ws2:longPathAware>true</ws2:longPathAware>
    </windowsSettings>
</application>

С CMD, к сожалению, это не сработает, на данный момент, из-за особенностей работы с путями, а в PowerShell должно всё заработать.

P.S.

На этом мой небольшой пятничный пост заканчивается, оставив за рамками вопросы полноты реализации поддержки длинных путей в Windows 10 (1607), или работоспособность при использовании различных комбинаций редакций Windows, файловых систем и API. По мере поступления новых фактов и результатов экспериментов пост будет обновляться.

Спасибо за внимание!

Если эта публикация вас вдохновила и вы хотите поддержать автора — не стесняйтесь нажать на кнопку

Большинство администраторов и пользователей Windows при работе с файлами, так или иначе сталкивались с ошибкой “path too long”. Эта ошибка возникает при превышении полного пути к файлу (вместе с его именем) значения 260 символов. Многие приложения, в том числе проводник Windows, неправильно работают с такими длинными именами файлов, оказываясь их открывать, перемещать и удалять. Это ограничение не файловой системы NTFS, а библиотеки Win32 API (подробнее о проблеме и обходных способах ее решения рассказано здесь).

В Windows 10 появилась возможность отключить ограничение на максимальную длину пути.

Отключить ограничение MAX_PATH можно двумя способами: с помощью редактора групповых политик или через реестр. Рассмотрим оба:

1. Запустите консоль редактора локальной групповой политики, нажав Win+R и выполнив команду gpedit.msc
2. Перейдите в раздел редактора Local Computer Policy -> Computer Configuration -> Administrative Templates -> System -> Filesystem -> NTFS (Конфигурация компьютера -> Административные шаблоны -> Система -> Файловая система -> NTFS)
   

   Картинка с сайта: winitpro.ru

3. Откройте политику Enable NTFS long paths
   

   Картинка с сайта: winitpro.ru

4. Включите политику, переведя ее в состояние Enabled
5. Сохраните изменения

При использовании домашней версии Windows 10, в которой отсутствует редактор GPO, это же изменение можно внедрить с помощью редактора реестра.

1. 1. Запустите редактор реестра regedit.exe
   2. Перейдите в ветку HKLM\SYSTEM\CurrentControlSet\Control\FileSystem
   3. Создайте в данной ветке новый параметр типа Dword (32-bit) Value с именем LongPathsEnabled
      

      Картинка с сайта: winitpro.ru

   4. Чтобы отключить ограничение MAX_PATH, измените значение ключа на 1

Также вы можете включить эту функцию одной командой PowerShell:
Set-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem -Name LongPathsEnabled -Value 1

Для вступления изменений в силу в обоих случаях требуется перезагрузка компьютера. После перезагрузки пользователи и программы смогут без ограничений работать с файлами, длина пути к которым превышает 260 символов. Теперь на файлы будет действовать только ограничение файловой системы NTFS – 32767 символов .

Этот функционал доступен всем пользователям Windows 10, начиная с Anniversary Update (1607), и в Windows Server 2016.

When testing development versions of Rtools for Windows, I’ve ran into
strange failures of several CRAN packages where R could not find, read from
or write to some files. The files should have been in temporary directories
which get automatically deleted, so it took some effort to find out that
actually they existed and were accessible. That didn’t make any sense at
first, but eventually I got to this output:

Warning in gzfile(file, "wb") :
  cannot open compressed file 'C:\msys64\home\tomas\ucrt3\svn\ucrt3\r_packages\pkgcheck\CRAN\ADAPTS\tmp\RtmpKWYapj/gList.Mast.cells_T.cells.follicular.helper_T.cells.CD4.memory.activated_T.cells.CD4.memory.resting_T.cells.CD4.naive_T.cells.C_Plasma.cells_B.cells.memory_B.cells.naive.RData.RData', probable reason 'No such file or directory'
Error in gzfile(file, "wb") : cannot open the connection
Calls: remakeLM22p -> save -> gzfile
Execution halted 

Such a long file name. The entire path in the warning message takes 265
bytes. Perhaps it is too long and, for some reason it can be created but not
read in a particular way?

To confirm the theory, I’ve created a mapped drive to get rid of the
/msys64/home/tomas/ucrt3/svn/ucrt3/r_packages/pkgcheck prefix of the path.
This package and several other started to pass their checks. Interestingly,
a junction didn’t work that well, because path normalization followed it in
some cases, getting again the long paths. R has been improved since and is
more likely to provide a hint (warning or error) that the path is too long,
so diagnosing the problem is often easier than this, yet the message may
also be too pessimistic (more below).

This text provides some background on path-length limits and offers
recommendations for what to do about them. It reports on recent
improvements in R, which allow R and packages to work with longer paths on
recent Windows 10, where and when the system limit can be overriden.

Following the changes in R, some of R packages will have to be updated as
well to work with long paths. Primarily authors of packages using
PATH_MAX or even MAX_PATH in their code are advised to continue reading.
The changes in R make the updating of packages possible (they can be
tested), but also more important (they could crash when seeing long paths).
It is therefore not advised to enable long paths on production systems, yet
— the feature needs to be considered experimental with the R ecosystem.

char cwd[MAX_PATH];
GetCurrentDirectory(MAX_PATH, cwd);

char *cwd;
DWORD res = GetCurrentDirectory(0, NULL);
cwd = (char *)malloc(res);
GetCurrentDirectory(res, cwd);

wchar_t *mydocs;
SHGetKnownFolderPath(&FOLDERID_Documents, KF_FLAG_CREATE, NULL, &mydocs);
// copy mydocs
CoTaskMemFree(mydocs);

 DWORD size = 1;
 char *buf = NULL;
    
 for(;;) {
     buf = (char *)malloc(size);
     if (!buf)
        return NULL;
     DWORD res = GetModuleFileName(NULL, buf, size);
     if (res > 0 && res < size) /* success */
         break;
     free(buf);
     if (res != size) /* error */
         return NULL;
     size *= 2; /* try again with 2x larger buffer */
 }

int iexts = 0;
const char *exts[] = { ".exe" , ".com" , ".cmd" , ".bat" , NULL };
while (exts[iexts]) {
  strcpy(dest, exts[iexts]);  // modifies fl
  if ((d = SearchPath(NULL, fl, NULL, MAX_PATH, fn, &f))) break;
  iexts++ ;
}

gList.Mast.cells_T.cells.follicular.helper_T.cells.CD4.memory.activated_T.cells.CD4.memory.resting_T.cells.CD4.naive_T.cells.C_Plasma.cells_B.cells.memory_B.cells.naive.RData.RData

Windows Server 2016 was finally released last week, meaning we can finally lift the idiotic 260 characters limitation for NTFS paths. In this post I’ll show you how to configure the «Enable Win32 long paths» setting for the NTFS file system, by a Group Policy Object (a GPO), and «LongPathsEnabled» in the Windows registry. This is still required for Windows Server 2022 and Windows Server 2019.

Maximum Path Length Limitation (MAX_PATH) in Windows Server

Microsoft writes about the Maximum Path Length Limitation on MSDN, and they write:

Maximum Path Length Limitation

In the Windows API (with some exceptions discussed in the following paragraphs), the maximum length for a path is MAX_PATH, which is defined as 260 characters. A local path is structured in the following order: drive letter, colon, backslash, name components separated by backslashes, and a terminating null character. For example, the maximum path on drive D is «D:\some 256-character path string<NUL>» where «<NUL>» represents the invisible terminating null character for the current system codepage. (The characters < > are used here for visual clarity and cannot be part of a valid path string.)

Microsoft Developer Network: Naming Files, Paths, and Namespaces

In the past, this 260 characters limitation caused errors and discomfort. Especially in the web hosting branche where you sometimes have to be able to save long file names. This resulted in (too) long paths and thus errors.

For example, have a look at this WordPress #36776 Theme update error Trac ticket. Which was a duplicate of #33053 download_url() includes query string in temporary filenames.

Fortunately, this limitation can now be unset and removed. Per default the limitation still exists though, so we need to set up a Local Group Policy. Or a Group Policy (GPO) in my case, since my server is in an Active Directory domain network.

In this post you’ll learn how to set up a GPO to enable NTFS long paths in Windows Server 2016 and Windows Server 2022/2019 using the LongPathsEnabled registry value.

Enabling «Long Paths» doesn’t magically remove the 260 character limit, it enables longer paths in certain situations. Adam Fowler has a bit more information about this is. Or are you wondering how to increase the configured maxUrlLength value in Windows Server & IIS? This’ll fix an IIS error «The length of the URL for this request exceeds the configured maxUrlLength value«.

But first things first.

You need to be able to set up this GPO using administrative templates (.admx) for Windows Server 2016. Because, in my situation, my Active Directory server is Windows Server 2012 R2 and doesn’t provide GPO settings for 2016.

Download Administrative Templates (.admx) for Windows 10 and Windows Server 2016

If you are, as me, on Windows Server 2012 R2 (at the time of this writing), you need administrative templates (.admx files) for Windows Server 2016 to configure 2016 specific Group Policy Objects. The same goes for Windows Server 2022 and 2019.

These few steps help you setting them up in your environment.

Download and install administrative templates for Windows Server 2016 in your Windows Server 2012 R2 Active Directory

Folow these steps:

1. Download Windows 10 and Windows Server 2016 specific administrative templates — or .admx files.
2. Install the downloaded .msi file Windows 10 and Windows Server 2016 ADMX.msi on a supported system: Windows 10 , Windows 7, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2. You also need user rights to run the Group Policy Management Editor (gpme.msc), or the Group Policy Object Editor (gpedit.msc). But that’s for later use.
3. The administrative templates are installed in C:\Program Files (x86)\Microsoft Group Policy\Windows 10 and Windows Server 2016, or whatever directory you provided during the installation. Copy over the entire folder PolicyDefinitions to your Primary Domain Controller’s SYSVOL\domain\Policies directory.
4. Verify you’ve copied the folder, and not just the files. The full path is: SYSVOL\domain\Policies\PolicyDefinitions. This is explained in Microsoft’s Technet article Managing Group Policy ADMX Files Step-by-Step Guide.

That’s it, you now have Group Policy Objects available for Windows Server 2016. Let’s enable Win32 long paths support now.

Configure «Enable Win32 long paths» Group Policy

Learn how to set up WMI filters for Group Policy.

Now that you have your Windows Server 2016 Group Policy Objects available, it’s time to setup a GPO to enable NTFS long path support. Create the GPO in your preferred location, but be sure to target it on Windows Server 2016 only.

Please note that the GPO is called Enable Win32 long paths, not NTFS.

Enabling Win32 long paths will allow manifested win32 applications and Windows Store applications to access paths beyond the normal 260 character limit per node on file systems that support it. Enabling this setting will cause the long paths to be accessible within the process.

Start your Group Policy Management console and click through to the location where you want to add the GPO. Create a new GPO: Create a GPO in this domain, and Link it here..., and provide your GPO with a relevant name.

In the Settings tab, right click and choose Edit…. Now under Computer Configuration in the Group Policy Management Editor, click through to Policies > Administrative Templates > System > Filesystem. Configure and enable the Setting Enable Win32 long paths.

!’This screen configures the GPO «Enable Win32 long paths»‘

Картинка с сайта: www.saotn.org

This is all you have to do to create the Group Policy for long Win32 paths. All that is left is to run gpupdate in an elevated cmd.exe command prompt.

Verify LongPathsEnabled registry value

If needed, you can use the following cmd.exe or PowerShell commands to verify the LongPathsEnabled registry value is set correctly:

C:\>reg query HKLM\System\CurrentControlSet\Control\FileSystem /v LongPathsEnabled

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\FileSystem
    LongPathsEnabled    REG_DWORD    0x1

PS C:\> (Get-ItemProperty "HKLM:System\CurrentControlSet\Control\FileSystem").LongPathsEnabled
1

Don’t forget about your Windows Server 2022 and Windows Server 2019 servers, they still require this LongPathsEnabled registy value.

Use PowerShell to configure «Enable Win32 long paths»

If your servers are not in an Active Directory network and you want to enable the «Win32 long paths» (or LongPathsEnabled registry value) you can use PowerShell for the job. Here is a small PowerShell script that adds the registry value if the script is run on an supported Windows Server version.

#
# Add LongPathsEnabled registry value using PowerShell
#
function Test-RegistryValue {
  param (
    [parameter(Mandatory = $true)]
    [ValidateNotNullOrEmpty()]
    [string]$Path,
    [parameter(Mandatory = $true)]
    [ValidateNotNullOrEmpty()]
    [string]$Value,
    [switch]$ShowValue
  )

  try {
    $Values = Get-ItemProperty -Path $Path | select-object -ExpandProperty $Value -ErrorAction Stop
    if ($ShowValue) {
      $Values
    }
    else {
      $true
    }
  }

  catch {
    $false
  }
}

# Windows Server 2016 build is 10.0.14393
[version]"10.0.14393"
[version] $winver = $(Get-CimInstance -Namespace root\cimv2 -Query "SELECT Version FROM Win32_OperatingSystem").Version

if($winver -ge [version]"10.0.14393") {
  if ($(Test-RegistryValue "HKLM:System\CurrentControlSet\Control\FileSystem" LongPathsEnabled) -eq $false) {
    New-ItemProperty -Path "HKLM:System\CurrentControlSet\Control\FileSystem" -Name LongPathsEnabled -PropertyType DWORD -Value 1 -Force
  }
}

This script contains a function that tries to look up if the requested registry path / value already exists. If it returns false, New-ItemProperty is executed to add LongPathsEnabled with value 1 to the Windows. A reboot afterwards is required.

Enable Win32 long paths in Windows 11 and Windows 10 (Bonus!)

If your client computer running Windows 11 or Windows 10 is not in an Active Directory and/or does not have the above mentioned GPO active, you can enable it yourself in a local security policy (LSP). You do need administrator privileges to follow the next steps:

1. As an administrator, start gpedit.msc for example in an elevated PowerShell terminal venster or through Start (Select the as administrator option). Press enter and Group Policy Editor opens.
2. Go to Local Computer Policy -> Computer Configuration -> Administrative Templates -> System -> Filesystem, then enable the Enable Win32 long paths option.
3. Restart your computer.

Картинка с сайта: www.saotn.org

Картинка с сайта: www.saotn.org

Картинка с сайта: www.saotn.org

Картинка с сайта: www.saotn.org

Of course you can add the registry value manually as well. Want to silently import .reg file in your Windows registry?

Did you like Enable NTFS long paths GPO in Windows Server 2022, 2019 and Windows Server 2016?

Then please, take a second to support Sysadmins of the North and donate!

Paypal

Your generosity helps pay for the ongoing costs associated with running this website like coffee, hosting services, library mirrors, domain renewals, time for article research, and coffee, just to name a few.

Windows Doesn’t Accept Long Paths by Default

Before Windows 95, Windows only allowed file names that were eight characters long, with a three-character file extension — commonly known as an 8.3 filename. Windows 95 abandoned that to allow long file names, but still limited the maximum path length (which includes the full folder path and the file name) to 260 characters. That limit has been in place ever since. If you’ve ever run into this limit, it was probably when you were trying to copy deep folder structures into other folders, such as when copying the contents of a hard drive to a folder on another drive. The Windows 10 Anniversary Update finally added the option to abandon that maximum path length.

There is one caveat. This new setting won’t necessarily work with every application out there, but it will work with most. Specifically, any modern applications should be fine, as should all 64-bit applications. Older 32-bit applications need to be manifested in order to work, which really just means that the developer has indicated in the application’s manifest file that the application supports longer paths. Most popular 32-bit apps should experience no problem. Still, you don’t risk anything by trying the setting out. If an application doesn’t work, the only thing that will happen is that it won’t be able to open or save files that are saved in places where the full path exceeds 260 characters.

Home Users: Remove the 260 Character Path Limit by Editing the Registry

If you have a Windows Home edition, you will have to edit the Windows Registry to make these changes. You can also do it this way if you have Windows Pro or Enterprise, but feel more comfortable working in the Registry than Group Policy Editor. (If you have Pro or Enterprise, though, we recommend using the easier Group Policy Editor, as described in the next section.)

To get started, open the Registry Editor by hitting Start and typing «regedit.» Press Enter to open Registry Editor and give it permission to make changes to your PC.

Картинка с сайта: www.howtogeek.com

In the Registry Editor, use the left sidebar to navigate to the following key:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem

Картинка с сайта: www.howtogeek.com

On the right, find a value named LongPathsEnabled and double-click it. If you don’t see the value listed, you’ll need to create it by right-clicking the FileSystem key, choosing New > DWORD (32-bit) Value, and then naming the new value LongPathsEnabled.

Картинка с сайта: www.howtogeek.com

In the value’s properties window, change the value from 0 to 1 in the «Value data» box and then click OK.

You can now close Registry Editor and restart your computer (or sign out of your account and sign back on). If you ever want to reverse the changes, just head back to the LongPathsEnabled value, and change it from 1 back to 0.

Download Our One-Click Registry Hack

Картинка с сайта: www.howtogeek.com

If you don’t feel like diving into the Registry yourself, we’ve created two downloadable registry hacks you can use. One hack removes the 260-character path limit, and the other hack restores the default limit. Both are included in the following ZIP file. Double-click the one you want to use, click through the prompts, and then restart your computer.

Long Path Names Hacks

These hacks are really just the FileSystem key, stripped down to the LongPathsEnabled value we described above, and then exported to a .REG file. Running the «Remove 260 Character Path Limit» hack sets the LongPathsEnabled value to 1. Running the «Restore 260 Character Path Limit (Default)» hack sets the value back to 0. And if you enjoy fiddling with the Registry, it’s worth taking the time to learn how to make your own Registry hacks.

Pro and Enterprise Users: Remove the 260 Character Path Limit with the Local Group Policy Editor

If you’re using Windows 10 Pro or Enterprise, the easiest way to disable the new app install notifications is by using the Local Group Policy Editor. It’s a pretty powerful tool, so if you’ve never used it before, it’s worth taking some time to learn what it can do. Also, if you’re on a company network, do everyone a favor and check with your admin first. If your work computer is part of a domain, it’s also likely that it’s part of a domain group policy that will supersede the local group policy, anyway.

In Windows 10 Pro or Enterprise, hit Start, type gpedit.msc, and press Enter.

Картинка с сайта: www.howtogeek.com

In the Local Group Policy Editor, in the left-hand pane, drill down to Computer Configuration > Administrative Templates > System > Filesystem. On the right, find the «Enable win32 long paths» item and double-click it.

Картинка с сайта: www.howtogeek.com

Select the «Enabled» option and then click «OK» in the properties window that opens.

Картинка с сайта: www.howtogeek.com

You can now exit the Local Group Policy Editor and restart your computer (or sign out and back in) to allow the changes to take effect. If at any time you want to reverse the changes, just follow the same procedure and set that option back to «Disabled» or «Not Configured.»

The maximum path limit may not be something you’ve ever run into, but for some people, it can certainly be the occasional frustration. Windows 10 has finally added the ability to remove that limit. You just have to make a quick change to the Registry or Group Policy to make it happen.