Función PathCchIsRoot (pathcch.h)

Determina si una cadena de ruta de acceso hace referencia a la raíz de un volumen.

Esta función difiere de PathIsRoot en que acepta rutas de acceso con prefijos "\", "\?" y "\?\UNC".

Sintaxis

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

Parámetros

[in, optional] pszPath

Puntero a la cadena de ruta de acceso.

Valor devuelto

Devuelve TRUE si la ruta de acceso especificada es una raíz o FALSE en caso contrario.

Comentarios

En la tabla siguiente se muestra el valor devuelto PathCchIsRoot para varias rutas de acceso.

Ruta de acceso	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

 

Esta función devuelve TRUE para rutas de acceso como "", "X:" o "\\server\share". Rutas de acceso como ".. \path2" o "\\server" devuelven FALSE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	pathcch.h
Library	Pathcch.lib