Compartir a través de

Función PathCchAppend (pathcch.h)

  • Artículo

Anexa una ruta de acceso al final de otra.

Esta función difiere de PathCchAppendEx en que está restringido a una ruta de acceso final de longitud MAX_PATH.

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

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchAppend(
  [in, out]      PWSTR  pszPath,
  [in]           size_t cchPath,
  [in, optional] PCWSTR pszMore
);

Parámetros

[in, out] pszPath

Puntero a un búfer que, en la entrada, contiene la ruta de acceso original. Cuando esta función se devuelve correctamente, el búfer contiene la ruta de acceso original más la ruta de acceso anexada.

[in] cchPath

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

[in, optional] pszMore

Puntero a la ruta de acceso que se va a anexar al final de la ruta de acceso a la que apunta pszPath. Las rutas de acceso UNC y las rutas de acceso que comienzan con la secuencia "\?" se aceptan y reconocen como rutas de acceso completas. Estas rutas de acceso reemplazan la cadena a la que apunta pszPath en lugar de anexarse a ella.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código HRESULT , incluido lo siguiente.

Código devuelto Descripción
E_INVALIDARG
 PszPath o pszMore es NULL, cchPath es 0 o cchPath es mayor que PATHCCH_MAX_CCH.
PATHCCH_E_FILENAME_TOO_LONG
 La cadena resultante superaría PATHCCH_MAX_CCH.
E_OUTOFMEMORY
 La función no pudo asignar un búfer del tamaño necesario.

Comentarios

Esta función inserta una barra diagonal inversa entre las dos cadenas, si una aún no está presente.

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

PathCchAppendEx