_mbccpy_s _mbccpy_s_l

複製資料的單一多位元組字元到另一個字串。這些是 _mbccpy _mbccpy_l 的安全性增強版本，如 安全性功能，則在 CRT 中 中所述。

重要事項
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

errno_t _mbccpy_s(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src 
);
errno_t _mbccpy_s_l(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src,
   locale_t locale
);
template <size_t size>
errno_t _mbccpy_s(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src 
); // C++ only
template <size_t size>
errno_t _mbccpy_s_l(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src,
   locale_t locale
); // C++ only

參數

• [out] dest
  複製目的地。

• [in] buffSizeInBytes
  目標緩衝區的大小。

• [out] pCopied
  使用複製的位元組數填滿 (1 或 2，如果成功的話)。傳遞 NULL ，如果您在數字的不會。

• [in] src
  複製的多位元組字元。

• [in] locale
  使用的地區設定。

傳回值

零，如果成功;在失敗時的錯誤碼。如果 src 或 dest 是 NULL，或者，如果超過 buffSizeinBytes 個位元組將會複製到 dest，然後不正確的參數叫用處理常式，如 參數驗證中所述。如果執行允許繼續執行，函式會傳回 EINVAL 和 errno 設定為 EINVAL。

備註

_mbccpy_s 函式複製 src 的多位元組字元加入至 dest。如果未指向多位元組字元的前導位元組 (如隱含呼叫 src 決定對 _ismbblead，則為 src 所複製的單一位元組。如果對前導位元組的 src 上，但以下位元組是 0 而不正確，則 0 複製到 dest， errno 設定為 EILSEQ函式會傳回 EILSEQ。

_mbccpy_s 不附加 null 結束字元;不過，則為，否則為 null 字元的 src ，該空點會複製到 dest (這是一般的單位元組複製)。

pCopied 中的值填入複製的位元組數目。如果作業成功，可能的值為 1 和 2。如果傳遞 NULL ，則會忽略這個參數。

請注意第二行是個特例第一個。同時也請注意資料表假設 buffSizeInBytes >= pCopied。

_mbccpy_s 在所有地區設定相關行為使用目前的地區設定。_mbccpy_s_l 與 _mbccpy_s 相同，除了地區設定為所有地區設定相關行為傳遞的 _mbccpy_s_l 使用。

在 C++ 中，使用這些函式由範本多載簡化;多載可自動推斷緩衝區的長度，不需要指定大小引數。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應

需求

如需更多關於相容性的資訊，請參閱入門介紹中的 相容性 (Compatibility) 。

請參閱

參考

地區設定

多位元組字元序列的轉譯工作

_mbclen，mblen _mblen_l