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 。