_mbsnbcpy、_mbsnbcpy_l

项目
06/09/2015

复制字符串的 n 字节到目标字符串。这些函数的更多安全版本都是可获得的，请参见 _mbsnbcpy_s、_mbsnbcpy_s_l。

重要

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

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 并将 errno 设置为 EINVAL。

输出值受区域设置的 LC_CTYPE 类设置影响；有关更多信息，请参见 setlocale、_wsetlocale。除了那些不具有_l 后缀使用当前的区域设置以及具有 _l 后缀而不是使用传入的区域设置参数，这些函数的版本都是相同的。有关详细信息，请参阅区域设置。

安全说明
这些函数可能容易受到的缓冲区溢出的威胁。缓冲区溢出可以用来执行任意代码攻击，这可能会导致特权的一个不必要的高度并且危及系统有关更多信息，请参见避免缓冲区溢出。