mbstowcs_s, _mbstowcs_s_l

Converts a sequence of multibyte characters to a corresponding sequence of wide characters. Versions of mbstowcs, _mbstowcs_l with security enhancements as described in Security Enhancements in the CRT.

복사

errno_t mbstowcs_s(

   size_t *pReturnValue,

   wchar_t *wcstr,

   size_t sizeInWords,

   const char *mbstr,

   size_t count 

);

errno_t _mbstowcs_s_l(

   size_t *pReturnValue,

   wchar_t *wcstr,

   size_t sizeInWords,

   const char *mbstr,

   size_t count,

   _locale_t locale

);

template <size_t size>

errno_t mbstowcs_s(

   size_t *pReturnValue,

   wchar_t (&wcstr)[size],

   const char *mbstr,

   size_t count 

); // C++ only

template <size_t size>

errno_t _mbstowcs_s_l(

   size_t *pReturnValue,

   wchar_t (&wcstr)[size],

   const char *mbstr,

   size_t count,

   _locale_t locale

); // C++ only

매개 변수

[out] pReturnValue pReturnValue을] [아웃

The number of characters converted. 문자 변환의 수입니다.

[out] [아웃] wcstr wcstr

The address of a sequence of wide characters. 넓은 문자의 순서의 주소입니다.

[in] sizeInWords sizeInWords] [에

The size of the wcstr buffer in words. 단어 버퍼의 크기 wcstr.

[in] []에 mbstr mbstr

The address of a sequence of null terminated multibyte characters. null이 일련의 주소는 멀티 바이트 문자가 종료되었습니다.

[in] count 카운트] [에

The maximum number of multibyte characters to convert, not including the terminating null, or _TRUNCATE . 멀티 바이트 문자의 수가 최대하거나로 변환 null이 아닌 포함한 종료 _TRUNCATE .

[in] locale 로케일] [에

The locale to use. 로케일 사용하기.

Return Value 반환 값

---

Zero if successful, an error code on failure. 0이면 성공, 실패에 오류 코드입니다.

Error condition 오류 조건	Return value and errno 반환 값과 Errno
wcstr is NULL and sizeInWords > 0 wcstr은 sizeInWords는 NULL과 0>	EINVAL EINVAL
mbstr is NULL mbstr이 Null입니다	EINVAL EINVAL
The destination buffer is too small to contain the converted string (unless count is _TRUNCATE ; see Remarks below) 대상 버퍼가 _TRUNCATE입니다 계산하지 않는 한 너무 작아서에 포함 (문자열을 변환; 아래 비고 참조)	ERANGE ERANGE

If any of these conditions occurs, the invalid parameter exception is invoked as described in Parameter Validation . 가 발생하면이 어떤 조건, 유효하지 않은 매개 변수 예외에 설명되어로 호출할 때 매개 변수 유효성 검사 . If execution is allowed to continue, the function returns an error code and sets errno as indicated in the table. 계속 진행하면 허용되는 집행이,이 함수는 집합을 반환하는 오류 코드 및 테이블 Errno과 같이 지적했다.