Función PathAppendW (shlwapi.h)

Anexa una ruta de acceso al final de otra.

Nota Uso incorrecto de esta función puede provocar una saturación del búfer. Se recomienda usar la función pathCchAppend de más segura o pathCchAppendEx en su lugar.

 

Sintaxis

BOOL PathAppendW(
  [in, out] LPWSTR  pszPath,
  [in]      LPCWSTR pszMore
);

Parámetros

[in, out] pszPath

Tipo: LPTSTR de

Puntero a una cadena terminada en null a la que se anexa la ruta de acceso especificada en pszMore. Debe establecer el tamaño de este búfer en MAX_PATH para asegurarse de que es lo suficientemente grande como para contener la cadena devuelta.

[in] pszMore

Tipo: LPCTSTR de

Puntero a una cadena terminada en null de longitud máxima MAX_PATH que contiene la ruta de acceso que se va a anexar.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

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

La ruta de acceso proporcionada en pszPath no puede comenzar con ".. \" o ".\" para generar una cadena de ruta de acceso relativa. Si está presente, esos puntos se quitan de la cadena de salida. Por ejemplo, anexando "path3" a ".. \path1\path2" da como resultado una salida de "\path1\path2\path3" en lugar de ".. \path1\path2\path3".

Ejemplos

#include <windows.h>
#include <iostream>
#include "Shlwapi.h"

using namespace std;

int main( void )
{
	// String for path name.
	char buffer_1[MAX_PATH] = "name_1\\name_2";
	char *lpStr1;
	lpStr1 = buffer_1;

	// String of what is being added.
	char buffer_2[ ] = "name_3";
	char *lpStr2;
	lpStr2 = buffer_2;

	cout << "The original path string is    " << lpStr1 << endl;
	cout << "The part to append to end is   " << lpStr2 << endl;
	bool ret = PathAppend(lpStr1,lpStr2);
	cout << "The appended path string is    " << lpStr1 << endl;
}

OUTPUT:
--------- 
The original path string is    name_1\name_2
The part to append to end is   name_3
The appended path string is    name_1\name_2\name_3

Nota

El encabezado shlwapi.h define PathAppend como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)