确定路径字符串是否引用卷的根。
此函数不同于 PathIsRoot ,因为它接受带有“\”、“\?”和“\?\UNC”前缀的路径。
语法
WINPATHCCHAPI BOOL PathCchIsRoot(
[in, optional] PCWSTR pszPath
);
参数
[in, optional] pszPath
指向路径字符串的指针。
返回值
如果指定的路径是根路径,则返回 TRUE ;否则返回 FALSE 。
注解
下表显示了各种路径的 PathCchIsRoot 返回值。
| 路径 | PathCchIsRoot |
|---|---|
| “c:\” | TRUE |
| “c:” | FALSE |
| “c:\path1” | FALSE |
| “\path1” | TRUE |
| “path1” | FALSE |
| “\\path1\path2” | TRUE |
| “\\path1\path2\” | FALSE |
| “\\path1\path2\path3” | FALSE |
| “\\path1” | TRUE |
| “\\path1\” | FALSE |
| "\\" | TRUE |
| “\\?\UNC\” | TRUE |
| “\\?\UNC\path1\path2” | TRUE |
| “\\?\UNC\path1\path2\” | FALSE |
| “\\?\UNC\path1\path2\path3” | FALSE |
| “\\?\UNC\path1” | TRUE |
| “\\?\UNC\path1\” | FALSE |
| “\\?\c:\” | TRUE |
| “\\?\c:” | FALSE |
| “\\?\c:\path1” | FALSE |
| “\\?\Volume{guid}\” | TRUE |
| “\\?\Volume{guid}” | FALSE |
| “\\?\Volume{guid}\path1” | FALSE |
| Null | false |
| "" | FALSE |
此函数为路径(如“”、“X:”或“\\server\share”)返回 TRUE。 路径,如“..\path2“或”\\server“返回 FALSE。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2012 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | pathcch.h |
| Library | Pathcch.lib |