_mbsnbcpy_s， _mbsnbcpy_s_l

项目
04/10/2013

复制字符串的 n 字节到目标字符串。这些是 _mbsnbcpy， _mbsnbcpy_l 的版本与安全增强如 CRT中的安全功能所述。

重要

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

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

参数

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

返回值

零，如果成功；EINVAL，如果一个错误的参数已通过。

备注

_mbsnbcpy_s 功能复制 strSource 的 count 字节到 strDest。如果 count 超过 strDest的大小，或者输入字符串为 null 指针，或者 sizeInBytes 或 count 为 0，函数调用的参数无效处理程序如参数验证所述。如果执行允许继续，该函数返回 EINVAL。如果源页和目标字符串重叠，_mbsnbcpy_s 行为不确定。

输出值受设置 LC_CTYPE 类设置的影响区域设置；请参见 setlocale 有关更多信息。这些功能的版本不 _l 后缀为该区域设置相关的行为使用当前区域设置；与 _l 后缀的版本相同，只不过它们使用传入的区域设置参数。有关更多信息，请参见区域设置。

备注

不同于此功能的不安全的版本，_mbsnbcpy_s 不执行任何空填充，并始终为 null 终止该字符串。

在 C++ 中，使用这些功能由模板超加载简化；超加载可能推断缓冲区长度 (自动不再需要指定范围参数)，并且还可以用以较新，安全重复自动替换旧，不安全的功能。有关更多信息，请参见安全模板重载。

这些函数的" debug "版本用 0xFD 首先加载缓冲区。若要禁用此行为，请使用 _CrtSetDebugFillThreshold。

一般文本例程映射