_mbsnbcpy, _mbsnbcpy_l

Kopya n bir dize hedef dize bayt.Bu işlevlerin daha güvenli sürümlerini — bkz: _mbsnbcpy_s, _mbsnbcpy_s_l.

Önemli notÖnemli

Bu API yürütün uygulamalarda kullanılamaz Windows Çalışma Zamanı.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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

Parametreler

  • strDest
    Hedef için kopyalanacak karakter dizesi.

  • strSource
    Kopyalanacak karakter dizesi.

  • count
    Kopyalanacak bayt sayısı.

  • locale
    Kullanılacak yerel ayarı.

Dönüş Değeri

_mbsnbcpyHedef karakter dizesi için bir işaretçi döndürür.Hiçbir değer döndürmeyen bir hatayı göstermek için ayrılmıştır.

Notlar

The _mbsnbcpy function copies count bytes from strSource to strDest.count Boyutunu aşıyor strDest veya üst üste, davranışı, kaynak ve hedef dizeleri _mbsnbcpy tanımlı değil.

strSource Veya strDest bir null işaretçi açıklandığı gibi bu işleve geçersiz parametre işleyicisini çağırır Parametre Doğrulama.İşlev verir yürütülmesine devam etmek için izin verilip verilmediğini, NULL ve errno için EINVAL.

Çıkış değeri ayarı tarafından etkilenen LC_CTYPE ; bölgesel ayar kategorisi bkz: setlocale, _wsetlocale daha fazla bilgi için.Bu işlevler sürümleri bu olanlar dışında olmayan, özdeş _l soneki kullanan yerel ve olan sürümleri _l soneki yerine geçirilen yerel parametresini kullanın.Daha fazla bilgi için bkz. Yerel Ayar.

Güvenlik NotuGüvenlik Notu

Bu işlevler, arabellek taşması tehditlere karşı savunmasız kalabilir.Arabellek taşmaları bir sistemin güvenliğini aşmasına ve unwarranted bir ayrıcalık yükselmesine neden saldırganın rasgele kod yürütmesine olanak kullanılabilir.Daha fazla bilgi için bkz: Kaçınma arabelleğin taşmasına neden.

Bu işlevleri C++'da, bu işlevlerin daha yeni ve daha güvenli karşılıkları çağırmak şablon aşırı yükleme vardır.Daha fazla bilgi için bkz. Güvenli Şablon Aşırı Yüklemeleri.

Genel metin eşlemeleri yordamına girildi

Tchar.h yordamına girildi

_UNICODE ve _mbcs tanımlanmamış

Tanımlanan _mbcs

Tanımlanan _UNICODE

_tcsncpy

strncpy

_mbsnbcpy

wcsncpy

_tcsncpy_l

_strncpy_l

_mbsnbcp_l

_wcsncpy_l

Gereksinimler

Yordamı

Gerekli başlık

_mbsnbcpy

<mbstring.h>

_mbsnbcpy_l

<mbstring.h>

Daha fazla uyumluluk bilgileri için bkz: Uyumluluk.

.NET Framework Eşdeğeri

Yoktur. Standart c işlevi çağırmak için kullanın PInvoke. Daha fazla bilgi için bkz. Platform Çağırma Örnekleri.

Ayrıca bkz.

Başvuru

Dize Düzenlemesi (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

_mbsnbset, _mbsnbset_l

strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l