_mbsnbcat_s, _mbsnbcat_s_l

아티클
04/10/2013

멀티 바이트 문자열에는 기껏해야 첫 번째 추가 n 다른 멀티 바이트 문자 문자열의 바이트 수입니다.이러한 버전의 수 _mbsnbcat, _mbsnbcat_l 에 설명 된 대로 보안을 강화 하 고 있는 CRT의 보안 기능.

중요
이 API를 실행 하는 응용 프로그램에서 사용할 수 있는 Windows 런타임.자세한 내용은 /zw에 지원 되는 CRT 함수.

errno_t _mbsnbcat_s(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count 
);
errno_t _mbsnbcat_s_l(
   unsigned char *dest,
   size_t sizeInBytes,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbcat_s(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
errno_t _mbsnbcat_s_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

dest
멀티 바이트 문자 대상 null로 끝나는 문자열입니다.
sizeInBytes
크기는 dest 버퍼의 바이트 수입니다.
src
멀티 바이트 문자 소스 null로 끝나는 문자열입니다.
Count
바이트 수를 src 에 추가할 dest.
locale
사용 하는 로캘.

반환 값

성공 하는 경우에 0입니다. 그렇지 않으면 오류 코드입니다.

오류 조건

Dest	sizeInBytes	src	반환 값
NULL	any	any	EINVAL
임의	< = 0	any	EINVAL
임의	any	NULL	EINVAL

오류 조건이 발생 하는 경우 함수가 잘못 된 매개 변수 오류에 설명 된 대로 생성 매개 변수 유효성 검사.함수 반환 오류 처리 EINVAL 를 설정 하 고 errno 에 EINVAL.

설명

_mbsnbcat_s 함수를 추가 하려면 dest, 기껏해야 첫 번째 count 바이트의 src.바이트의 null 문자 바로 앞에 경우 dest 의 선행 바이트 인지 초기 바이트 덮어씁니다 src.그렇지 않으면 초기 바이트의 src 의 null 종결 문자를 덮어씁니다 dest.Null 바이트 있는 경우 src 전에 count 바이트 추가 됩니다, _mbsnbcat_s 에서 모든 바이트를 추가 src를 null 문자까지.경우 count 의 길이 보다 큰 경우 src, 길이 src 대신 사용 됩니다 count.결과 문자열에 null 문자가 종료 됩니다.중복 문자열 사이 복사를 사용 하면 동작이 정의 되지 않습니다.

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

C + +에서는 이러한 함수를 사용 하는 템플릿 오버 로드에 의해 간단해 집니다. 오버 로드 버퍼 길이 자동으로 유추 되므로 size 인수를 지정할 필요가 없습니다 및 수는 자동으로 그 새로운, 보다 안전한 기능 보안 수준이 낮은 오래 된 함수로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

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

일반 텍스트 루틴 매핑