_mbsnbcpy, _mbsnbcpy_l

Artikel
02/26/2013

Kopiert n Bytes einer Zeichenfolge zu einer Zielzeichenfolge.Sicherere Versionen dieser Funktionen sind AVAILABLE-sehen _mbsnbcpy_s, _mbsnbcpy_s_l.

Wichtig
Diese API kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /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

Parameter

strDest
Ziel, damit die Zeichenfolge kopiert werden kann.
strSource
Kopiert werden Zeichenfolge.
count
Zahl kopiert werden Bytes.
locale
Zu verwendende Gebietsschema.

Rückgabewert

_mbsnbcpy gibt einen Zeiger auf die Zielzeichenfolge zurück.Kein Rückgabewert wird reserviert, um einen Fehler anzugeben.

Hinweise

Die _mbsnbcpy-Funktion kopiert count Bytes von strSource zu strDest.Wenn count die Größe von strDest überschreitet, oder die Quell- und Zielzeichenfolgen überschneiden, wird das Verhalten von _mbsnbcpy nicht definiert.

Wenn strSource oder strDest ein NULL-Zeiger ist, Aufrufe dieser Funktion der ungültige Parameterhandler, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, gibt die Funktion NULL zurück und legt errno zu EINVAL fest.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; setlocale, _wsetlocale finden Sie weitere Informationen.Die Versionen dieser Funktionen sind identisch, nur die, die nicht die _l Suffixverwendung das aktuelle Gebietsschema und die Versionen haben, die das _l Suffix stattdessen den Gebietsschemaparameter verwendet werden, der übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Sicherheitshinweis
Diese Funktionen sind möglicherweise für Pufferüberlaufbedrohungen anfällig.Pufferüberläufe können verwendet werden, um beliebigen Angreifercode auszuführen, der eine unbefugte Ausweitung seine Berechtigungen ausweitet verursachen und das System gefährdet.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen.

In C++ sind diese Funktionen Vorlagenüberladungen, die die neueren aufrufen, sichereren Entsprechungen dieser Funktionen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuordnung generische Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcsncpy	strncpy	_mbsnbcpy	wcsncpy
_tcsncpy_l	_strncpy_l	_mbsnbcp_l	_wcsncpy_l

Anforderungen

Routine	Erforderlicher Header
_mbsnbcpy	<mbstring.h>
_mbsnbcpy_l	<mbstring.h>

Weitere Kompatibilitätsinformation finden Sie unter Kompatibilität.

.NET Framework-Entsprechung

Nicht zutreffend. Um die Standard-C-Funktion aufzurufen, verwenden Sie PInvoke. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.