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 コードが返されます。

リターン コード 説明
E_INVALIDARG
pszPath または pszMoreNULLcchPath が 0、または cchPathPATHCCH_MAX_CCHより大きい。
PATHCCH_E_FILENAME_TOO_LONG
結果の文字列が PATHCCH_MAX_CCHを超えます。
E_OUTOFMEMORY
関数は、必要なサイズのバッファーを割り当てませんでした。

注釈

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

要件

要件
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー pathcch.h
Library Pathcch.lib

こちらもご覧ください

PathCchAppendEx