Función PathCchRemoveFileSpec (pathcch.h)

  • Artículo

Quita el último elemento de una cadena de ruta de acceso, tanto si ese elemento es un nombre de archivo como un nombre de directorio. También se quita la barra diagonal inversa inicial del elemento.

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

NotaEsta función debe usarse en lugar de PathRemoveFileSpec para evitar la posibilidad de que un búfer se supere.

Sintaxis

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

Parámetros

[in, out] pszPath

Puntero a la cadena de ruta de acceso completa. Cuando esta función se devuelve correctamente, la cadena tendrá su último elemento y se quitará la barra diagonal inversa inicial. Esta función no afecta a las rutas de acceso raíz, como "C:". En el caso de una ruta de acceso raíz, la cadena de ruta de acceso se devuelve sin modificar. Si una cadena de ruta de acceso termina con una barra diagonal inversa final, solo se quita esa barra diagonal inversa.

[in] cchPath

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

Valor devuelto

Esta función devuelve S_OK si la función se realizó correctamente, S_FALSE si no hay nada que quitar o un código de error en caso contrario.

Comentarios

En la tabla siguiente se muestra el efecto de esta función en una selección de cadenas de ruta de acceso.

Cadena original Cadena devuelta
"C:\path1" "C:\"
"C:\path1\path2" "C:\path1"
"C:\path1\" "C:\path1"
"\\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