Функция 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