_mbsnbcat_s, _mbsnbcat_s_l

Article
03/26/2013

Ajoute à une chaîne de caractères multioctets, au plus, les premiers octets d' n d'une autre chaîne de caractères multioctets.Ce sont des versions de _mbsnbcat, _mbsnbcat_l qui ont des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité du CRT.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Paramètres

dest
Chaîne de destination à caractères multioctets se terminant par null.
sizeInBytes
Taille de la mémoire tampon d' dest en octets.
src
Chaîne à caractères multioctets se terminant par null source.
Count
Nombre d'octets d' src à ajouter à dest.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Zéro si l'opération a réussi ; sinon, le code d'erreur.

Conditions d'erreur

Dest	sizeInBytes	src	Valeur de retour
NULL	any	any	EINVAL
Any	<= 0	any	EINVAL
Any	any	NULL	EINVAL

Si les conditions d'erreur l'une des cas, la fonction génère une erreur de paramètre non valide, comme décrit dans Validation des paramètres.Si l'erreur est gérée, la fonction retourne EINVAL et définit errno à EINVAL.

Notes

La fonction d' _mbsnbcat_s ajoute à dest, au plus, les premiers octets d' count d' src.Si l'octet qui précède immédiatement le caractère Null dans dest est un octet de tête, il est remplacé par l'octet initial d' src.Sinon, l'octet initial d' src remplace le caractère NULL de fin d' dest.Si un octet null apparaît dans src avant que les octets d' count soient ajoutés, _mbsnbcat_s ajoute tous les octets d' src, jusqu'au caractère Null.Si count est supérieur à la longueur d' src, la longueur d' src est utilisée à la place d' count.La chaîne résultante est effectuée par un caractère Null.Si copier nécessaire entre les chaînes qui se chevauchent, le comportement est pas défini.

La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPE des paramètres régionaux ; consultez setlocale, _wsetlocale pour plus d'informations.Les versions de ces fonctions sont identiques, mais que celles qui n'ont pas l'utilisation de suffixe d' _l les paramètres régionaux et ceux qui font utiliser le suffixe d' _l à la place le paramètre de paramètres régionaux qui est passé.Pour plus d'informations, consultez Paramètres régionaux.

En C++, l'utilisation de ces fonctions est simplifiée par des surcharges de modèle ; les surcharges peuvent également déduire la longueur de la mémoire tampon automatiquement et éviter ainsi le besoin de spécifier un argument de taille, et peuvent utiliser automatiquement les plus récentes, plus sécurisées fonctions pour substituer les fonctions plus anciennes et inférieur sécurisées.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

Les versions debug de ces fonctions exécutent d'abord mémoire tampon de 0xFD.Pour désactiver ce comportement, utilisez _CrtSetDebugFillThreshold.

Mappages de routines de texte générique