Export (0) Print
Expand All
Expand Minimize

_mbsnbcpy

Copies n bytes of a string to a destination string.

unsigned char * _mbsnbcpy(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count 
);

Parameters

strDest
Destination for character string to be copied.
strSource
Character string to be copied.
count
Number of bytes to be copied.

Return Value

_mbsnbcpy returns a pointer to the destination character string. No return value is reserved to indicate an error.

Remarks

The _mbsnbcpy function copies count bytes from strSource to strDest. If count is less than or equal to the size in bytes of strSource, a null character is not appended automatically to the copied string. If size in bytes of strSource is less than count, the destination buffer is padded with null characters. If count exceeds the size of strDest, or if the source and destination strings overlap, the behavior of _mbstrncpy is undefined.

Security Note    This API incurs a potential threat brought about by a buffer overrun problem. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege. For more information, see Avoiding Buffer Overruns.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_tcsncpy strncpy _mbsnbcpy wcsncpy

Requirements

Routine Required header Compatibility
_mbsnbcpy <mbstring.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

String Manipulation Routines | _mbsnbcat | _mbsnbcmp | _mbsnbcnt, _mbsnccnt | _mbsnbicmp | _mbsnbset | _mbsncpy | Run-Time Routines and .NET Framework Equivalents

Show:
© 2014 Microsoft