Compartir a través de

Función PathCchRemoveBackslashEx (pathcch.h)

  • Artículo

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

Esta función difiere de PathCchRemoveBackslash en que puede devolver un puntero al nuevo final de la cadena e informar del número de caracteres sin usar que quedan en el búfer.

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

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchRemoveBackslashEx(
  [in, out]       PWSTR  pszPath,
  [in]            size_t cchPath,
  [out, optional] PWSTR  *ppszEnd,
  [out, optional] size_t *pcchRemaining
);

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.

[out, optional] ppszEnd

Valor que, cuando esta función devuelve correctamente, recibe la dirección de un puntero al final de la nueva cadena. Si la cadena es una ruta de acceso raíz como "C:", el puntero apunta a la barra diagonal inversa; de lo contrario, el puntero apunta al carácter nulo de terminación de la cadena.

[out, optional] pcchRemaining

Puntero a un valor que, cuando esta función devuelve correctamente, recibe el número de caracteres sin usar en el búfer de destino, incluido el carácter nulo de terminación. Si la cadena es una ruta de acceso raíz como "C:", este recuento incluye la barra diagonal inversa en esa cadena.

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