PathCchAppend 関数 (pathcch.h)
あるパスを別のパスの末尾に追加します。
この関数は PathCchAppendEx とは異なり、長さMAX_PATHの最終パスに制限されます。
この関数は PathAppend とは異なり、"\"、"\?" および "\?\UNC" プレフィックスを持つパスを受け入れます。
メモバッファー オーバーランが発生しないようにするには、PathAppend の代わりにこの関数 (PathCchAppendEx) を使用する必要があります。
構文
WINPATHCCHAPI HRESULT PathCchAppend(
[in, out] PWSTR pszPath,
[in] size_t cchPath,
[in, optional] PCWSTR pszMore
);
パラメーター
[in, out] pszPath
エントリ時に元のパスを含むバッファーへのポインター。 この関数が正常に返されると、バッファーには元のパスと追加されたパスが含まれます。
[in] cchPath
pszPath が指すバッファーのサイズ (文字単位)。
[in, optional] pszMore
pszPath が指すパスの末尾に追加するパスへのポインター。 "\?" シーケンスで始まる UNC パスとパスは、完全修飾パスとして受け入れられ、認識されます。 これらのパスは、追加されるのではなく、 pszPath が指す文字列を置き換えます。
戻り値
この関数が成功すると、 S_OKが返されます。 それ以外の場合は、次のような HRESULT コードが返されます。
リターン コード | 説明 |
---|---|
|
pszPath または pszMore が NULL、cchPath が 0、または cchPath がPATHCCH_MAX_CCHより大きい。 |
|
結果の文字列が PATHCCH_MAX_CCHを超えます。 |
|
関数は、必要なサイズのバッファーを割り当てませんでした。 |
注釈
この関数は、2 つの文字列の間に円記号を挿入します (まだ存在しない場合)。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | pathcch.h |
Library | Pathcch.lib |