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