_mbsnbcpy_s, _mbsnbcpy_s_l

Článek
06/09/2015

Zkopíruje n bajtů řetězce do cílového řetězce.Tyto verze _mbsnbcpy, _mbsnbcpy_l mají rozšíření zabezpečení popsaná v tématu Funkce zabezpečení v CRT.

Důležité
Toto API nelze použít v aplikacích, které jsou spuštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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

Parametry

strDest
Cíl pro řetězec znaků, které chcete zkopírovat.
sizeInBytes
Velikost vyrovnávací paměti pro cílové umístění.
strSource
Znakový řetězec, který chcete zkopírovat.
count
Počet bajtů, které mají být zkopírovány.
locale
Použité národní prostředí.

Vrácená hodnota

Nula v případě úspěchu; EINVAL, pokud byl předán chybný parametr.

Poznámky

Funkce _mbsnbcpy_s kopíruje count bajtů z strSource do strDest.Pokud count přesahuje velikost strDest, některý ze vstupních řetězců je ukazatel s hodnotou null, nebo je sizeInBytes nebo count 0, funkce vyvolá obslužnou rutinu neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, funkce vrátí EINVAL.Pokud se zdrojový a cílový řetězec překrývají, chování _mbsnbcpy_s není definováno.

Výstupní hodnota je ovlivněna nastavením kategorie LC_CTYPE národního prostředí; viz setlocale pro další informace.Verze těchto funkcí bez přípony _l používají aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze s příponou _l jsou stejné s tím rozdílem, že používají předaný parametr národního prostředí.Další informace naleznete v tématu Národní prostředí.

[!POZNÁMKA]

Na rozdíl od nezabezpečené verze této funkce _mbsnbcpy_s neprovádí padding hodnotou null a vždy ukončí řetězec hodnotou null.

V jazyce C++ je použití těchto funkcí zjednodušeno díky přetížení šablon; přetížení dokáží odvodit velikost vyrovnávací paměti automaticky (tak, že eliminují potřebu zadat argument velikosti) a automaticky nahradit starší, nezabezpečené funkce jejími novějšími, bezpečnějšími protějšky.Další informace naleznete v tématu Přetížení zabezpečení šablony.

Ladicí verze těchto funkcí nejprve naplní vyrovnávací paměť hodnotou 0xFD.Chcete-li zakázat toto chování, použijte _CrtSetDebugFillThreshold.

Rutinní mapování obecného textu