Función PathCchAddBackslashEx (pathcch.h)

Artículo
03/05/2024

Agrega una barra diagonal inversa al final de una cadena para crear la sintaxis correcta para una ruta de acceso. Si la ruta de acceso de origen ya tiene una barra diagonal inversa final, no se agregará ninguna barra diagonal inversa.

Esta función difiere de PathCchAddBackslash 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 PathAddBackslash en que acepta rutas de acceso con prefijos "\", "\?" y "\?\UNC".

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchAddBackslashEx(
  [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 vuelve correctamente, el búfer contiene la cadena con la barra diagonal inversa anexada. Este valor no debe ser NULL.

[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 carácter nulo de terminación al final de la cadena.

[out, optional] pcchRemaining

Un puntero a un valor que, cuando esta función devuelve correctamente, se establece en el número de caracteres sin usar en el búfer de destino, incluido el carácter nulo de terminación.

Valor devuelto

Esta función devuelve S_OK si la función se realizó correctamente, S_FALSE si la cadena de ruta de acceso ya termina en una barra diagonal inversa o un código de error de lo contrario.

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

Consulte también

PathCchAddBackslash