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 または pszMore が NULL、cchPath が 0、または cchPath がPATHCCH_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