_mbsnbcpy, _mbsnbcpy_l

Article
03/26/2013

Copie des octets d' n d'une chaîne à une chaîne de destination.Les versions sécurisées de ces fonctions sont disponible- consultez _mbsnbcpy_s, _mbsnbcpy_s_l.

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.

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

Paramètres

strDest
Destination pour que la chaîne de caractères est copiée.
strSource
Chaîne de caractères à copier.
count
Nombre d'octets à copier.
locale
Paramètres régionaux à utiliser.

Valeur de retour

_mbsnbcpy retourne un pointeur vers une chaîne de caractères de destination.Aucune valeur de retour n'est réservée pour indiquer une erreur.

Notes

La fonction d' _mbsnbcpy copie des octets d' count d' strSource à strDest.Si count dépasse la taille d' strDest ou la source et les chaînes de destination se chevauchent, le comportement d' _mbsnbcpy est pas défini.

Si strSource ou strDest est un pointeur null, cette fonction appelle le gestionnaire de paramètre non valide comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, la fonction retourne NULL et définit errno à EINVAL.

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 ceux qui n'ont pas l'utilisation de suffixe d' _l les paramètres régionaux et des versions 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.

Note de sécurité
Ces fonctions peuvent être vulnérables aux menaces de dépassement de mémoire tampon.Les dépassements de mémoire tampon peuvent être utilisés pour exécuter du code arbitraire d'un intrus, qui peut provoquer une élévation de privilège injustifiée et compromettre le système.Pour plus d'informations, consultez l' Solutions contre les dépassements de mémoire tampon.

En C++, ces fonctions ont des surcharges de modèle qui appellent des équivalents plus récentes et plus sûres de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

Mappages de routines de texte générique