Función PathCchRemoveBackslash (pathcch.h)

Quita la barra diagonal inversa final del final de una cadena de ruta de acceso.

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

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchRemoveBackslash(
  [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, la cadena contiene la ruta de acceso con cualquier barra diagonal inversa final quitada. Si no se encontró ninguna barra diagonal inversa final, la cadena no cambia.

[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 la cadena era una ruta de acceso raíz o si no se encontró ninguna barra diagonal inversa o un código de error de lo contrario.

Comentarios

Esta función no quitará la barra diagonal inversa de una cadena de ruta de acceso raíz, como "C:".

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