_mbsnbcpy _mbsnbcpy_l

Článek
03/26/2013

Kopie n bajtů řetězce pro cílový řetězec.Bezpečnější verze tyto funkce jsou k dispozici, naleznete v _mbsnbcpy_s _mbsnbcpy_s_l.

Důležité
Toto rozhraní API nelze použít v aplikacích, které jsou spuštěny v Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /ZW.

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

Parametry

strDest
Cíl pro řetězec znaků, které mají být zkopírovány.
strSource
Znakový řetězec, který chcete zkopírovat.
count
Počet bajtů, které mají být zkopírovány.
locale
Chcete-li národní prostředí pro použití.

Vrácená hodnota

_mbsnbcpyvrací ukazatel na řetězec znaků cíl.Žádné vrácená hodnota je vyhrazena udávající chybu.

Poznámky

The _mbsnbcpy function copies count bytes from strSource to strDest.Pokud count přesahuje velikost strDest nebo zdrojového a cílového řetězce překrývají, chování _mbsnbcpy není definován.

Pokud strSource nebo strDest ukazatel s hodnotou null, je tato funkce vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno zpracování, chcete-li pokračovat, vrátí funkce NULL a errno na EINVAL.

Výstupní hodnota je ovlivněna nastavením LC_CTYPE kategorie nastavení národního prostředí; Viz setlocale _wsetlocale Další informace.Verze tyto funkce jsou shodné, s výjimkou, že ty, které nemají _l příponu použít aktuální národní prostředí a verze, které mají _l přípony, použijte parametr locale, který je předán v.Další informace naleznete v tématu Národní prostředí.

Poznámka k zabezpečení
Tyto funkce může být zranitelný vůči hrozbám přetečení vyrovnávací paměti.Přeběhy vyrovnávací paměti lze provést libovolný útočník kód, který může způsobit, že bude vyplacena neoprávněně zvýšení úrovně oprávnění a napadnout počítač se systémem.Další informace naleznete v tématu Zamezení způsobí přetečení vyrovnávací paměti.

V jazyce C++ mají tyto funkce šablony přetížení, které vyvolávají novější, bezpečnější protějšky těchto funkcí.Další informace naleznete v tématu Přetížení šablony zabezpečení.

Mapování rutiny obecného textu