_mbsnbcpy_s, _mbsnbcpy_s_l

Artikel
06/09/2015

Kopiert n Bytes einer Zeichenfolge in eine Zielzeichenfolge. Diese Versionen von _mbsnbcpy, _mbsnbcpy_l enthalten Sicherheitserweiterungen wie unter Sicherheitsfunktionen in der CRT beschrieben.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

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

Parameter

strDest
Ziel für die zu kopierende Zeichenfolge.
sizeInBytes
Größe des Zielpuffers.
strSource
Zu kopierende Zeichenfolge.
count
Anzahl der zu kopierenden Bytes.
locale
Zu verwendendes Gebietsschema.

Rückgabewert

Bei Erfolg gleich 0 (null); EINVAL, wenn ein ungültiger Parameter übergeben wurde.

Hinweise

Die _mbsnbcpy_s-Funktion kopiert count Bytes von strSource nach strDest. Wenn count die Größe von strDest überschreitet, ist eine der Eingabezeichenfolgen ein NULL-Zeiger, oder wenn sizeInBytes oder count 0 (null) ist, ruft die Funktion, wie in Parametervalidierung beschrieben, den Handler für ungültige Parameter auf. Wenn die weitere Ausführung zugelassen wird, gibt die Funktion EINVAL zurück. Wenn sich Quell- und Zielzeichenfolgen überlappen, ist das Verhalten von _mbsnbcpy_s undefiniert.

Der Ausgabewert ist von der LC_CTYPE-Kategorieneinstellung des Gebietsschemas betroffen; weitere Informationen finden Sie unter setlocale. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Versionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch stattdessen den ihnen übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

Hinweis

Anders als die nicht sichere Version dieser Funktion füllt _mbsnbcpy_s nichts mit 0 (null) auf, und die Zeichenfolge wird immer mit NULL beendet.

In C++ wird die Verwendung dieser Funktionen durch Vorlagenüberladungen vereinfacht; die Überladungen können automatisch Rückschlüsse auf die Pufferlänge ziehen (wodurch kein Größenargument mehr angegeben werden muss), und sie können automatisch die älteren, nicht sicheren Funktionen durch ihre neueren, sicheren Entsprechungen ersetzen. Weitere Informationen finden Sie unter Sichere Vorlagenüberladungen.

Die Debugversionen dieser Funktionen füllen zunächst den Puffer mit "0xFD" auf. Mit _CrtSetDebugFillThreshold deaktivieren Sie dieses Verhalten.

Zuordnung generischer Textroutinen