PathAppendW, fonction (shlwapi.h)

Ajoute un chemin à la fin d’un autre.

Syntaxe

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

Paramètres

[in, out] pszPath

Type : LPTSTR

Pointeur vers une chaîne terminée par null à laquelle le chemin spécifié dans pszMore est ajouté. Vous devez définir la taille de cette mémoire tampon sur MAX_PATH pour vous assurer qu’elle est suffisamment grande pour contenir la chaîne retournée.

[in] pszMore

Type : LPCTSTR

Pointeur vers une chaîne terminée par null de longueur maximale MAX_PATH qui contient le chemin d’accès à ajouter.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Cette fonction insère automatiquement une barre oblique inverse entre les deux chaînes, si elle n’est pas déjà présente.

Le chemin fourni dans pszPath ne peut pas commencer par .. \ » ou « .\ » pour produire une chaîne de chemin d’accès relatif. Si elles sont présentes, ces points sont supprimés de la chaîne de sortie. Par exemple, ajout de « path3 » à .. \path1\path2 » génère une sortie de « \path1\path2\path3 » plutôt que « .. \path1\path2\path3".

Exemples

#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

Exigences