_mbsnbcpy_s, _mbsnbcpy_s_l

아티클
06/09/2015

이 n 대상 문자열에 문자열의 바이트를 복사하세요. 이러한 버전의 _mbsnbcpy, _mbsnbcpy_l에는 CRT의 보안 기능에 설명된 대로 보안 향상 기능이 포함됩니다.

중요

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

errno_t _mbsnbcpy_s(
   unsigned char * strDest,
   size_t sizeInBytes,
   const unsigned char * strSource,
   size_t count 
);
errno_t _mbsnbcpy_s_l(
   unsigned char * strDest,
   size_t sizeInBytes,
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcpy_s(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcpy_s_l(
   unsigned char (&strDest)[size],
   const unsigned char * strSource,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

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

반환 값

성공 하면 0; 잘못 된 매개 변수가 전달 되는 경우 EINVAL 입니다.

설명

이 _mbsnbcpy_s 함수는 strSource 에서 strDest으로 count 을 복사합니다. 이 count 가 strDest의 크기를 넘어서면, 어느 쪽 입력 문자열은 null 포인터, sizeInBytes 혹은 0인 count 이거나, 함수는 매개 변수 유효성 검사 로 설명된 잘못된 매개 변수 처리기를 포함합니다. 계속해서 실행하도록 허용된 경우, 함수는 EINVAL를 로 설정합니다. 원본 영역과 대상 문자열이 겹치는 경우 _mbsnbcpy_s 동작이 지정되지 않습니다.

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

참고

이 함수는 안전하지 않은 버전과 달리, _mbsnbcpy_s 는 null 채움을 실행 되지 않으며 항상 null 문자열을 종료합니다.

C++에서는 템플릿 오버로드로 인해 이러한 함수를 사용하는 것이 보다 간단해 집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으며(크기 인수를 지정할 필요가 없어짐), 기존의 비보안 함수를 보다 최신의 보안 대응 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

이러한 함수의 디버그 버전은 우선 0xFD로 버퍼를 채웁니다. 이 동작을 사용하지 않으려면 _CrtSetDebugFillThreshold를 사용하십시오.

제네릭 텍스트 라우팅 매핑