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 |