PathCombineW 関数 (shlwapi.h)
正しく形成されたパスを表す 2 つの文字列を 1 つのパスに連結します。では、相対パス要素も連結されます。
構文
LPWSTR PathCombineW(
[out] LPWSTR pszDest,
[in, optional] LPCWSTR pszDir,
[in] LPCWSTR pszFile
);
パラメーター
[out] pszDest
種類: LPTSTR
この関数が正常に返されると、結合されたパス文字列を受け取るバッファーへのポインター。 返される文字列を保持するのに十分な大きさになるように、このバッファーのサイズを MAX_PATH に設定する必要があります。
[in, optional] pszDir
種類: LPCTSTR
最初のパスを含む最大長MAX_PATHの null で終わる文字列へのポインター。 この値には NULL を指定できます。
[in] pszFile
種類: LPCTSTR
2 番目のパスを含む最大長MAX_PATHの null で終わる文字列へのポインター。 この値には NULL を指定できます。
戻り値
種類: LPTSTR
この関数が正常に返されると、連結されたパス文字列を受け取るバッファーへのポインター。 これは pszPathOut が指すのと同じ文字列です。 この関数が正常に返されない場合、この値は NULL です。
解説
ディレクトリ パスは、A:、B:、...、Z: の形式にする必要があります。 ファイル パスは、パスのファイル名部分を表す正しい形式にする必要があります。 ディレクトリ パスが円記号で終わる場合は、円記号が維持されます。 lpszDir と lpszFile はどちらも省略可能なパラメーターですが、どちらも NULL にすることはできません。
例
#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"
int main( void )
{
// Buffer to hold combined path.
char buffer_1[MAX_PATH] = "";
char *lpStr1;
lpStr1 = buffer_1;
// String for balance of path name.
char buffer_2[ ] = "One\\Two\\Three";
char *lpStr2;
lpStr2 = buffer_2;
// String for directory name.
char buffer_3[ ] = "C:";
char *lpStr3;
lpStr3 = buffer_3;
cout << "The file path to be combined is "
<< lpStr2 << endl;
cout << "The directory name path is "
<< lpStr3 << endl;
cout << "The combined path is "
<< PathCombine(lpStr1,lpStr3,lpStr2) << endl;
}
------------
INPUT:
------------
Path for directory part: "C:"
Path for file part: "One\Two\Three"
------------
OUTPUT:
------------
The file path to be combined is One\Two\Three
The directory name path is C:
The combined path is C:\One\Two\Three
Note
shlwapi.h ヘッダーは PathCombine をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlwapi.h |
| Library | Shlwapi.lib |
| [DLL] | Shlwapi.dll (バージョン 4.71 以降) |