_mbsnbcpy, _mbsnbcpy_l

Artigo
02/25/2013

Bytes de n copia-se de uma cadeia de caracteres em uma cadeia de caracteres de destino.Versões mais seguros dessas funções são disponível- consulte _mbsnbcpy_s, _mbsnbcpy_s_l.

Importante
Este API não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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

Parâmetros

strDest
Destino para que a cadeia de caracteres é copiada.
strSource
Cadeia de caracteres a serem copiados.
count
Número de bytes a serem copiados.
locale
A localidade usar.

Valor de retorno

_mbsnbcpy retorna um ponteiro para a cadeia de caracteres de destino.Nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função de _mbsnbcpy copia bytes de count de strSource a strDest.Se count excede o tamanho de strDest ou cadeias de caracteres de origem e de destino sobrepostos, o comportamento de _mbsnbcpy é indefinido.

Se strSource ou strDest são um ponteiro zero, essa função chama o manipulador inválido de parâmetros como descrito em Validação de parâmetro.Se a execução é permitida continuar, a função retorna NULL e defina errno a EINVAL.

O valor de saída é afetado pela configuração da categoria de LC_CTYPE de localidade; consulte setlocale, wsetlocale para mais informações.As versões dessas funções são idênticas, exceto que aquelas que não têm o uso do sufixo de _l a localidade atual e as versões que têm o sufixo de _l usar o parâmetro de localidade que é passado.Para obter mais informações, consulte Localidade.

Observação de segurança
Essas funções podem ser vulneráveis armazenar em buffer ameaças de estouro.Estouros de buffer podem ser usadas para executar código arbitrário do invasor, que pode causar uma despropositado elevação de privilégio e confirmar o sistema.Para obter mais informações, consulte Evitando estouros de buffer.

Em C++, essas funções têm as sobrecargas que chamam o mais recente, mais seguros contrapartes do modelo dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto