StrCatChainW 函数（shlwapi.h）

连接两个 Unicode 字符串。当需要重复串联到同一缓冲区时使用。

语法

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

[out] pszDst

类型：PWSTR

指向缓冲区的指针，当此函数成功返回时，接收以 null 结尾的 Unicode 字符串。

cchDst

类型：DWORD

目标缓冲区的大小（以字符为单位）。此缓冲区的大小必须足够，才能同时保存两个字符串和终止 null 字符。如果缓冲区太小，将截断最终字符串。

ichAt

类型：DWORD

目标缓冲区中开始追加作的偏移量。如果字符串不为空，请将此值设置为 -1，以便为你计算的当前填充字符数（不包括终止 null 字符）。

[in] pszSrc

类型：PCWSTR

指向以 null 结尾的 Unicode 源字符串的指针。

类型：DWORD

返回添加到 pszDst的最后一个字符后空字符的偏移量。

安全警告：使用此函数可能会损害应用程序的安全性。不能保证最终字符串以 null 结尾。请考虑使用以下替代方法之一：StringCbCatEx、StringCbCatNEx、StringCchCatEx或 StringCchCatNEx。在继续之前，应查看安全注意事项：Microsoft Windows Shell。