_mbsnbcpy_s, _mbsnbcpy_s_l

아티클
04/10/2013

복사본 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잘못 된 매개 변수가 전달 된 경우.

설명

The _mbsnbcpy_s function copies count bytes from strSource to strDest.경우 count 크기를 초과 strDest가 입력된 문자열의 null 포인터인 경우입니다 또는 sizeInBytes 또는 count 0, 함수에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사 .함수 실행을 계속 하도록 허용 된 경우, 반환 EINVAL.원본 및 대상 문자열 겹칠 경우의 동작을 _mbsnbcpy_s 정의 되어 있지 않습니다.

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

[!참고]

이 함수는 안전 하지 않은 버전과 달리 _mbsnbcpy_s null 패딩을 하지 하지 않고 항상 null 문자열 종료 합니다.

C + +에서는 이러한 함수를 사용 하 여 템플릿 오버 로드에 의해 단순화 됩니다. 오버 로드에서 버퍼 길이 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없도록) 및 해당 최신, 안전한 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

이러한 함수의 디버그 버전이 먼저 0xFD 사용 하 여 버퍼를 채웁니다.이 동작을 비활성화 하려면 _CrtSetDebugFillThreshold.

일반 텍스트 루틴 매핑