_mbccpy_s, _mbccpy_s_l

멀티 바이트 문자 하나 하나의 문자열을 다른 문자열에 복사합니다.이러한 버전의 수 _mbccpy, _mbccpy_l 에 설명 된 대로 보안 향상 기능을 CRT의 보안 기능.

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

errno_t _mbccpy_s(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src 
);
errno_t _mbccpy_s_l(
   unsigned char *dest,
   size_t buffSizeInBytes,
   int * pCopied,
   const unsigned char *src,
   locale_t locale
);
template <size_t size>
errno_t _mbccpy_s(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src 
); // C++ only
template <size_t size>
errno_t _mbccpy_s_l(
   unsigned char (&dest)[size],
   int * pCopied,
   const unsigned char *src,
   locale_t locale
); // C++ only

매개 변수

• [out] dest
  대상으로 복사 합니다.

• [in] buffSizeInBytes
  대상 버퍼의 크기입니다.

• [out] pCopied
  바이트 복사 (1 또는 2를 성공적으로 수행 하는 경우) 번호를 입력 합니다.전달 NULL 번호에 대 한 상관 하지 않는 경우.

• [in] src
  멀티 바이트 문자 복사 합니다.

• [in] locale
  사용 하는 로캘.

반환 값

성공 하는 경우에 0입니다. 실패 시 오류 코드입니다.경우 src 또는 dest 는 NULL, 또는 둘 이상의 buffSizeinBytes 바이트를 복사 합니다 dest에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 하 고 매개 변수 유효성 검사.실행을 계속 하도록 허용 된 경우에 함수 반환 EINVAL 및 errno 로 설정 된 EINVAL.

설명

_mbccpy_s 함수에서 하나의 멀티 바이트 문자 복사 src 에 dest.경우 src 따라 암시적으로 호출 하 여 멀티 바이트 문자의 선행 바이트를 가리키지 않는 _ismbblead, 다음은 단일 바이트는 src 지점으로 복사 됩니다.경우 src 선행 바이트 있지만 다음 바이트를 가리키는 0 및 따라서 잘못 된 다음 0 복사 dest, errno 로 설정 된 EILSEQ, 함수를 반환 하 고 EILSEQ.

_mbccpy_snull 종결자를 추가 하지 않습니다. 그러나 경우 src 해당 null 복사 되 고 하는 null 문자를 가리키는 dest (일반 단일 바이트 복사본 뿐입니다).

값을 pCopied 복사 되는 바이트 수를 입력 합니다.작업에 성공 하면 가능한 값은 1과 2입니다.경우 NULL 전달 되어,이 매개 변수는 무시 됩니다.

두 번째 행 첫 번째 특수 한 경우만 되었음.테이블을 가정 하는 참고도 buffSizeInBytes > = pCopied.

_mbccpy_s현재 로케일에 대 한 모든 로캘별 동작을 사용합니다._mbccpy_s_l동일한 _mbccpy_s 제외 하 고 _mbccpy_s_l 모든 로캘 종속 동작에 대해 전달 된 로캘을 사용 하 여.

C + +에서는 이러한 함수를 사용 하 여 템플릿 오버 로드에 의해 단순화 됩니다. 오버 로드 버퍼 길이가 size 인수를 지정 하지 않아도 자동으로 유추할 수 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

일반 텍스트 루틴 매핑

요구 사항

자세한 호환성에 대 한 내용은 호환성 소개에서 합니다.

참고 항목

참조

로캘

멀티 바이트 문자 시퀀스로 해석

_mbclen, mblen, _mblen_l