_mbsnbcpy, _mbsnbcpy_l

Articolo
03/26/2013

Copia i byte di n di una stringa in una stringa di destinazione.Più versioni sicure di queste funzioni sono disponibile- vedere _mbsnbcpy_s, _mbsnbcpy_s_l.

Importante
Questa API non può essere utilizzato nelle applicazioni eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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

Parametri

strDest
Destinazione della stringa di caratteri vengano copiati.
strSource
Stringa di caratteri da copiare.
count
Numero di byte da copiare.
locale
Impostazioni locali da utilizzare.

Valore restituito

_mbsnbcpy restituisce un puntatore alla stringa di caratteri di destinazione.Nessun valore restituito è riservato per indicare un errore.

Note

La funzione di _mbsnbcpy copia di byte count da strSource a strDest.Se count supera la dimensione di strDest o il database di origine e stringhe di destinazione si sovrappongono, il comportamento di _mbsnbcpy è definito.

Se strSource o strDest è un puntatore null, chiamare questa funzione del gestore non valido di parametro come descritto in Convalida dei parametri.Se l'esecuzione può continuare, la funzione restituisce NULL e imposta errno su EINVAL.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria di LC_CTYPE delle impostazioni locali; vedere setlocale, _wsetlocale per ulteriori informazioni.Le versioni di queste funzioni sono identiche, ma quelle che non prevedono l'utilizzo di _l le impostazioni locali correnti e le versioni che hanno il suffisso di _l utilizzare invece il parametro delle impostazioni locali passato.Per ulteriori informazioni, vedere Impostazioni locali.

Nota sulla sicurezza
Queste funzioni potrebbero essere vulnerabile a rischi di sovraccarico del buffer.I sovraccarichi del buffer possono essere utilizzati per eseguire codice arbitrario di attacco, che può causare un'elevazione dei privilegi ingiustificata e compromettere il sistema.Per ulteriori informazioni, vedere Evitare sovraccarichi del buffer.

In C++, queste funzioni in overload che richiama il più recente, più il modello controparti sicure di queste funzioni.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a Testo generico