MultiByteToWideChar
함수는 멀티바이트 문자열을 유니코드 문자열로 변환하는 Windows API 함수입니다.
이 함수는 특정 코드 페이지를 사용하여 멀티바이트 문자열을 유니코드로 변환합니다.
함수 원형은 다음과 같습니다:
int MultiByteToWideChar(
UINT CodePage,
DWORD dwFlags,
LPCSTR lpMultiByteStr,
int cbMultiByte,
LPWSTR lpWideCharStr,
int cchWideChar
);
각 매개변수의 의미는 다음과 같습니다:
-
CodePage
: 변환에 사용할 코드 페이지를 지정합니다. 예를 들어, 한국어의 경우949
(ANSI/OEM - Korean (Unified Hangul Code))를 사용합니다. 코드 페이지 상수로CP_ACP
등을 사용할 수 있습니다. -
dwFlags
: 변환 동작을 제어하는 플래그로, 일반적으로0
을 사용합니다. -
lpMultiByteStr
: 변환할 멀티바이트 문자열의 포인터입니다. -
cbMultiByte
: 변환할 멀티바이트 문자열의 길이입니다. 이 값이-1
이면 함수는 문자열이 null로 종료된 것으로 간주합니다. -
lpWideCharStr
: 변환된 유니코드 문자열을 저장할 버퍼의 포인터입니다. -
cchWideChar
: 유니코드 문자열 버퍼의 크기입니다.
함수의 반환값이 0
이면 변환에 실패한 것이며, 이 경우 GetLastError()
를 호출하여 오류 정보를 확인할 수 있습니다. 주로 출력 버퍼의 크기가 충분하지 않거나 입력 문자열이 너무 길 때 오류가 발생합니다.
이 함수는 멀티바이트 문자열을 유니코드로 변환할 때 유용하게 사용됩니다.
'Windows' 카테고리의 다른 글
File System Functionality Comparison (마이크로소프트 문서 win32 깃허브) (0) | 2022.05.11 |
---|---|
[scoop] 윈도우즈에서 유닉스/리눅스 툴을 쉽게 설치하기 (0) | 2018.10.02 |
Windows Vista에서 UAC 권한 상승을 통한 SetLocalTime 함수 호출 테스트 (0) | 2007.07.12 |
DLU Dialog Units (0) | 2007.06.13 |
SAFEARRAY 사용법 정리 (1) | 2007.04.03 |