PathCchIsRoot 函数 (pathcch.h)

确定路径字符串是否引用卷的根。

此函数不同于 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