通过

StrCatBuffA 函数 (shlwapi.h)

  • 项目

复制一个字符串中的字符并将其追加到另一个字符串的末尾。

注意 请勿使用。 有关备用函数，请参阅备注。
 

语法

PSTR StrCatBuffA(
  [in, out] PSTR  pszDest,
  [in]      PCSTR pszSrc,
            int   cchDestBuffSize
);

参数

[in, out] pszDest

类型： PTSTR

指向以 null 结尾的字符串的指针。 当此函数成功返回时，此字符串包含其原始内容，并追加了 字符串 pszSrc 。

[in] pszSrc

类型： PCTSTR

指向要追加到 pszDest 的字符串的指针。

cchDestBuffSize

类型： int

pszDest 指向的缓冲区的大小（以字符为单位）。 此值必须至少是组合字符串的长度加上终止 null 字符。 如果缓冲区太小，无法容纳整个字符串，则字符串将被截断。

返回值

类型： PTSTR

返回一个指向目标字符串的指针。

注解

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

注意

shlwapi.h 标头将 StrCatBuff 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)