Поделиться через

Функция PathCchIsRoot (pathcch.h)

  • Статья

Определяет, ссылается ли строка пути на корень тома.

Эта функция отличается от PathIsRoot тем, что она принимает пути с префиксами "\", "\?" и "\?\UNC".

Синтаксис

WINPATHCCHAPI BOOL PathCchIsRoot(
  [in, optional] PCWSTR pszPath
);

Параметры

[in, optional] pszPath

Указатель на строку пути.

Возвращаемое значение

Возвращает значение TRUE , если указанный путь является корневым, или false в противном случае.

Комментарии

В следующей таблице показано возвращаемое значение PathCchIsRoot для различных путей.

Путь PathCchIsRoot
"c:\" TRUE
"c:" Ложь.
"c:\path1" Ложь.
"\path1" TRUE
"path1" Ложь.
"\\path1\path2" TRUE
"\\path1\path2\" Ложь.
"\\path1\path2\path3" Ложь.
"\\path1" TRUE
"\\path1\" Ложь.
"\\" TRUE
"\\?\UNC\" TRUE
"\\?\UNC\path1\path2" TRUE
"\\?\UNC\path1\path2\" Ложь.
"\\?\UNC\path1\path2\path3" Ложь.
"\\?\UNC\path1" TRUE
"\\?\UNC\path1\" Ложь.
"\\?\c:\" TRUE
"\\?\c:" Ложь.
"\\?\c:\path1" Ложь.
"\\?\Volume{guid}\" TRUE
"\\?\Volume{guid}" Ложь.
"\\?\Volume{guid}\path1" FALSE
NULL FALSE
"" Ложь.
 

Эта функция возвращает значение TRUE для таких путей, как "", "X:" или "\\server\share". Пути, такие как ".. \path2" или "\\server" возвращает значение FALSE.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header pathcch.h
Библиотека Pathcch.lib