PathAppendA 関数 (shlwapi.h)

1 つのパスを別のパスの末尾に追加します。

メモ この関数を誤用すると、バッファー オーバーランが発生する可能性があります。 より安全な PathCchAppend 関数または PathCchAppendEx 関数を使用することをお勧めします。

 

構文

BOOL PathAppendA(
  [in, out] LPSTR  pszPath,
  [in]      LPCSTR 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

Note

shlwapi.h ヘッダーは、PathAppend をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 4.71 以降)