函数功能

函数语法

参数

返回值

注意(安全警告： 备注：)

函数功能

该函数把第二个参数指定的字符串复制到第一个参数指定的字符串，第三个参数指定复制的长度。

函数语法

LPTSTR lstrcpyn( __out LPTSTR lpString1, __in LPCTSTR lpString2, __in int iMaxLength);

参数

lpString1 ：指向一个缓冲区，以存储第二参数的内容。需足够长以容纳第三参数设定的TCHAR值，以及NULL结束符“\\0”；

lpString2 ：指向以NULL结尾"\\0"的字符串；

iMaxLength ：指定从第二参数复制至第一参数内容的大小，包括NULL结束符"\\0"（谨记bytes字节数对应ANSI 版本以及WCHAR值对应Unicode版本）。

返回值

该函数返回指向缓冲区的指针（即使源字符串长于第三参数所指定长度，函数succeed）。

如果失败，返回NULL,lpString1不以空字符串"\\0"结束。

注意

安全警告：

第一参数如果过小，会导致缓存溢出；如果是Unicode版本，sizeof()返回的是字节数，而不是WCHAR，这就会导致缓存区溢出；缓存溢出可能导致严重问题。考虑使用 sizeof(szString1)/sizeof(szString1[0])得到适当的大小。

（可以考虑使用 StringCchCopy 函数代替）

备注：

缓冲区指向必须足够大以包含结束符；实例：

TCHAR chBuffer[512]; lstrcpyn(chBuffer, "abcdefghijklmnop", 4);

此例结果为“abc”以及一个空结束符被复制至chBuffer。

（第一次对照MSDN Help翻译，难免有错，请多包涵指正，谢谢）