_mbsnbcpy， _mbsnbcpy_l

项目
04/10/2013

复制字符串的 n 字节到目标字符串。这些功能的更安全的版本可用参见 _mbsnbcpy_s， _mbsnbcpy_s_l。

重要

此 API 不能在 Windows 运行时执行的应用程序。有关更多信息，请参见 CRT 函数不支持与 /ZW。

unsigned char * _mbsnbcpy(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count
);
unsigned char * _mbsnbcpy_l(
   unsigned char * strDest,
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char * _mbsnbcpy(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count
); // C++ only
template <size_t size>
unsigned char * _mbsnbcpy_l(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
); // C++ only

参数

strDest
要复制的字符字符串的目标。
strSource
要复制的字符字符串。
count
要复制的字节数。
locale
使用的区域设置。

返回值

_mbsnbcpy 返回指向目标字符字符串。没有任何返回值保留指示错误。

备注

_mbsnbcpy 功能复制 strSource 的 count 字节到 strDest。如果 count 超过 strDest 的大小或源和目标字符串重叠，_mbsnbcpy 行为不确定。

如果 strSource 或 strDest 是 null 指针，此函数调用的参数无效处理程序如参数验证所述。如果执行允许继续，该函数返回 NULL 并将 errno 到 EINVAL。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale， _wsetlocale 有关更多信息。这些功能的版本是没有 _l 后缀使用当前区域设置和版本有 _l 后缀使用区域设置参数传递的相同，不同之处在于，这些。有关更多信息，请参见区域设置。

安全说明
这些功能可能容易受到的缓冲区溢出威胁。缓冲区溢出可用于执行任意攻击者代码，可能会导致权限未确保提升和削弱系统。有关更多信息，请参见避免缓冲区溢出。