The lstrcpyn function copies a specified number of characters from a source string into a buffer.
LPTSTR lstrcpyn(
| LPTSTR lpString1, | // address of target buffer |
| LPCTSTR lpString2, | // address of source string |
| int iMaxLength | // number of bytes or characters to copy |
| ); |
Parameters
lpString1
Points to a buffer into which the function copies characters. The buffer must be large enough to contain the number of bytes (ANSI version) or characters (Unicode version) specified by iMaxLength, including room for a terminating null character.
lpString2
Points to a null-terminated string from which the function copies characters.
iMaxLength
Specifies the number bytes (ANSI version) or characters (Unicode version) to be copied from the string pointed to by lpString2 into the buffer pointed to by lpString1, including a terminating null character.
Return Values
If the function succeeds, the return value is a pointer to the buffer.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.
Remarks
Note that the buffer pointed to by lpString1 must be large enough to include a terminating null character, and the string length value specified by iMaxLength includes room for a terminating null character. Thus, the following code
TCHAR chBuffer[512] ;
lstrcpyn(chBuffer, "abcdefghijklmnop", 4) ;
... copies the string "abc", followed by a terminating null character, to chBuffer.
See Also