Função PathAppendW (shlwapi.h)

Acrescenta um caminho ao final de outro.

Sintaxe

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

Parâmetros

[in, out] pszPath

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo à qual o caminho especificado em pszMore é acrescentado. Você deve definir o tamanho desse buffer para MAX_PATH para garantir que ele seja grande o suficiente para manter a cadeia de caracteres retornada.

[in] pszMore

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o caminho a ser acrescentado.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Essa função insere automaticamente uma barra invertida entre as duas cadeias de caracteres, se uma ainda não estiver presente.

O caminho fornecido em pszPath não pode começar com ".. \" ou ".\" para produzir uma cadeia de caracteres de caminho relativo. Se estiverem presentes, esses períodos serão retirados da cadeia de caracteres de saída. Por exemplo, acrescentando "path3" a ".. \path1\path2" resulta em uma saída de "\path1\path2\path3" em vez de ".. \path1\path2\path3".

Exemplos

#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

Requisitos