_mbsnbcpy, _mbsnbcpy_l

아티클
06/09/2015

이 n 대상 문자열에 문자열의 바이트를 복사하세요. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _mbsnbcpy_s, _mbsnbcpy_s_l을 참조하십시오.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

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

매개 변수

strDest
복사될 문자열의 대상입니다.
strSource
복사할 문자열입니다.
count
복사할 바이트 수입니다.
locale
사용할 로캘입니다.

반환 값

_mbsnbcpy는 대상 문자열을 가리키는 포인터를 반환합니다. 반환 값 없음은 오류를 나타내는 데 예약되어 있습니다.

설명

이 _mbsnbcpy 함수는 strSource 에서 strDest으로 count 을 복사합니다. count가 strDest의 크기를 초과하고, 원본 및 대상 문자열이 겹치면, _mbsnbcpy의 동작은 정의되지 않습니다.

strSource 또는 strDest는 null 포인터입니다. 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 함수는 NULL 를 반환하고 errno 을 EINVAL으로 설정합니다.

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale, _wsetlocale을 참조하십시오. _l12 접미사를 가지지 않은 함수가 현재 로캘을 사용하고 _l 접미사를 가진 함수는 대신 전달된 로캘 매개 변수를 사용한다는 점을 제외하고 이러한 버전의 함수는 동일합니다. 자세한 내용은 로캘을 참조하십시오.

보안 정보
이러한 함수는 버퍼 오버런 위협에 노출될 수 있습니다.버퍼 오버런은 보증되지 않은 권한 승격을 초래하거나 또는 시스템을 위태롭게 하는 임의적인 공격자 코드를 실행하기 위해 사용될 수 있습니다.자세한 내용은 버퍼 오버런 방지를 참조하십시오.