Función PathCchStripToRoot (pathcch.h)

  • Artículo

Quita todos los elementos de archivo y directorio de una ruta de acceso, excepto la información raíz.

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

Nota Esta función se debe usar en lugar de PathStripToRoot para evitar la posibilidad de que se supere un búfer.

Sintaxis

WINPATHCCHAPI HRESULT PathCchStripToRoot(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parámetros

[in, out] pszPath

Puntero a la cadena de ruta de acceso. Cuando esta función devuelve correctamente, esta cadena contiene solo la información raíz tomada de esa ruta de acceso.

[in] cchPath

Tamaño del búfer al que apunta pszPath, en caracteres.

Valor devuelto

Esta función devuelve S_OK si la ruta de acceso se trunca, S_FALSE si la ruta de acceso ya era una raíz o un código de error HRESULT .

Comentarios

Algunos ejemplos del efecto de esta función:

Cadena inicial Cadena final
"C:\path1\path2\file" "C:\"
"\\path1\path2\path3" "\\path1\path2"
"\path1" "\"

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