_mbsnbcat_s _mbsnbcat_s_l

發行項
03/27/2013

對多位元組字元字串的附加，最多，第一個 n 位元組其他多位元組字元字串。這些是有安全性增強 _mbsnbcat _mbsnbcat_l 的版本，如安全性功能，則在 CRT 中中所述。

重要事項
這個應用程式開發介面無法用來在 Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

參數

dest
null 結尾多位元組字元的字串。
sizeInBytes
dest 緩衝區的大小 (以位元組為單位)。
src
null 結尾多位元組字元來源字串。
Count
位元組數從附加的 src 為 dest。
locale
使用的地區設定。

傳回值

零，如果成功;否則，錯誤碼。

錯誤情況

Dest	sizeInBytes	src	傳回值
NULL	any	any	EINVAL
Any	<= 0	any	EINVAL
Any	any	NULL	EINVAL

如果有任何錯誤發生，函式會產生不正確的參數錯誤，如參數驗證中所述。如果錯誤已處理，則函式會傳回 EINVAL 和 errno 設為 EINVAL。

備註

為 dest的 _mbsnbcat_s 函式，附加至多，第一個 count 位元組 src。如果緊接在 dest 中的 null 字元之前的位元組是前導位元組，則初始位元組 src覆寫。否則，初始位元組 src 覆寫 dest結束的 null 字元。如果 NULL 位元組出現於 src ，在 count 位元組附加前，附加 _mbsnbcat_s 從 src中的所有位元組，由 null 字元。如果 count 大於 src的長度，長度 src 在 count位置。這個結果的字串是 null 字元結束。如果複製發生在重疊的字串之間，行為是未定義。

輸出值受地區設定的 LC_CTYPE 類別設定的設定所影響;請參閱 setlocale _wsetlocale 以取得詳細資訊。這些函式版本相同，不過，沒有 _l 結尾使用目前的地區設定和該排列 _l 結尾使用地區設定參數傳遞的型別。如需詳細資訊，請參閱地區設定。

在 C++ 中，使用這些函式由範本多載簡化;多載可自動推斷緩衝區長度進而排除指定大小引數，，且可以自動使用它們較新，更安全的函式取代舊，降低安全性函式。如需詳細資訊，請參閱安全範本多載。

這些函式的偵錯版本會先填入 0xFD 緩衝區。若要停用此行為，請使用 _CrtSetDebugFillThreshold 。

泛用文字常式對應