PathAppendW 関数 (shlwapi.h)

あるパスを別のパスの末尾に追加します。

構文

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

パラメーター

[in, out] pszPath

種類: LPTSTR

pszMore で指定されたパスが追加される null で終わる文字列へのポインター。 返される文字列を保持するのに十分な大きさになるように、このバッファーのサイズを MAX_PATH に設定する必要があります。

[in] pszMore

型: LPCTSTR

追加するパスを含む最大長MAX_PATHの null で終わる文字列へのポインター。

戻り値

種類: BOOL

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。

注釈

この関数は、2 つの文字列の間に円記号を自動的に挿入します (まだ存在しない場合)。

pszPath で指定されたパスは、 で始めることはできません。\" または ".\" を指定すると、相対パス文字列が生成されます。 存在する場合、これらの期間は出力文字列から削除されます。 たとえば、"path3" を に追加します。\path1\path2" は、".ではなく"\path1\path2\path3" という出力になります。\path1\path2\path3"

例

#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

要件