2006/06/30일자로 MSDN 다운로드 센터에 간단한 유틸리티 함수를 제공하는 "Microsoft National Language Support Downlevel APIs 1.0"이 올라왔습니다.
다음의 기사를 참고하십시오.
Microsoft National Language Support Downlevel APIs 1.0
;
https://www.sysnet.pe.kr/2/1/353
그런데, 잠시 테스트해 볼려고 VS.NET 2005에서 예제로 MFC Dialog 유형의 프로젝트를 만들어서 다음과 같은 코드를 컴파일 해보았습니다.
#include "..\include\Nlsdl.h"
#pragma comment( lib, "..\\lib\\x86\\Nlsdl.lib" )
LCID lcid = DownlevelLocaleNameToLCID( L"ko-KR", DOWNLEVEL_LOCALE_NAME );
// lcid == 1024
LCID parentLcid = DownlevelGetParentLocaleLCID( lcid );
// lcid == 18
wchar_t name[ 1024 ] = { 0 };
DownlevelLCIDToLocaleName( lcid, name, 1024, 0 );
// name == "ko-KR"
wchar_t parentName[ 1024 ] = { 0 };
DownlevelGetParentLocaleName( lcid, parentName, 1024 );
// parentName == "ko"
그런데 ^^; 이게 웬일입니까?
다음과 같은 오류가 나는 것입니다.
TestDlgDlg.obj : error LNK2019: unresolved external symbol "int __stdcall DownlevelGetParentLocaleName(unsigned long,wchar_t *,int)" (?DownlevelGetParentLocaleName@@YGHKPA_WH@Z) referenced in function "protected: virtual int __thiscall CTestDlgDlg::OnInitDialog(void)" (?OnInitDialog@CTestDlgDlg@@MAEHXZ)
TestDlgDlg.obj : error LNK2019: unresolved external symbol "int __stdcall DownlevelLCIDToLocaleName(unsigned long,wchar_t *,int,unsigned long)" (?DownlevelLCIDToLocaleName@@YGHKPA_WHK@Z) referenced in function "protected: virtual int __thiscall CTestDlgDlg::OnInitDialog(void)" (?OnInitDialog@CTestDlgDlg@@MAEHXZ)
TestDlgDlg.obj : error LNK2019: unresolved external symbol "unsigned long __stdcall DownlevelLocaleNameToLCID(wchar_t const *,unsigned long)" (?DownlevelLocaleNameToLCID@@YGKPB_WK@Z) referenced in function "protected: virtual int __thiscall CTestDlgDlg::OnInitDialog(void)" (?OnInitDialog@CTestDlgDlg@@MAEHXZ)
C:\Microsoft NLS Downlevel APIs\TestDlg\Debug\TestDlg.exe : fatal error LNK1120: 3 unresolved externals
분명히, Nlsdl.h 파일에 정의된 대로 정확하게 사용을 했는데 위와 같은 에러가 나는 것입니다.
오호... Microsoft가 뭔가 실수를 했을까요?
우선, Nlsdl.h 파일에 있는 정의 대로 LIB 파일에 있는지 검사를 해야 했습니다. 여러 가지 툴을 사용해 볼 수 있겠지만, 단순히 export 된 함수에 대한 signature만 확인하면 되기 때문에 그냥 LIB 파일을 VS.NET IDE로 끌어다 놓아서 binary 형식으로 보았습니다.
아래와 같이 export 되어 있는 것을 확인해 볼 수 있는데요.
CRIPTOR_Nlsdl__NULL_IMPORT_DESCRIPTOR
Nlsdl_NULL_THUNK_DATA
?DownlevelLocaleNameToLCID@@YGKPBGK@Z__imp_
?DownlevelLocaleNameToLCID@@YGKPBGK@Z
?DownlevelLCIDToLocaleName@@YGHKPAGHK@Z__imp_
?DownlevelLCIDToLocaleName@@YGHKPAGHK@Z
?DownlevelGetParentLocaleLCID@@YGKK@Z__imp_
?DownlevelGetParentLocaleLCID@@YGKK@Z
?DownlevelGetParentLocaleName@@YGHKPAGH@Z__imp_
?DownlevelGetParentLocaleName@@YGHKPAGH@Z
그런데, 한 가지 이상한 점이 있습니다. 함수 이름 이후의 "@@" 문자뒤에 오는 signature 값이 VS.NET 컴파일 화면에 있는 값과 일치하지 않았습니다.
컴파일 오류 : ?DownlevelLocaleNameToLCID@@YGKPB_WK@Z
LIB export : ?DownlevelLocaleNameToLCID@@YGKPBGK@Z
자, 그럼 위의 signature를 우리가 읽기 편하게 변환을 하면 될 텐데요. 이를 위해 VC++ 툴에 있는 "undname.exe"를 이용해 보겠습니다. (자세한 사항은
https://www.sysnet.pe.kr/2/0/151을 참조하십시오.)
결국, 다음과 같은 결과를 얻어냈습니다.
컴파일 오류 : ?DownlevelLocaleNameToLCID@@YGKPB_WK@Z
- unsigned long __stdcall DownlevelLocaleNameToLCID(wchar_t const *,unsigned long)
LIB export : ?DownlevelLocaleNameToLCID@@YGKPBGK@Z
- unsigned long __stdcall DownlevelLocaleNameToLCID(unsigned short const *, unsigned long)"
확실히 다르군요. ^^ 그런데, Nlsdl.h 파일에는 해당 함수에 대해서 다음과 같이 선언되어져 있습니다.
LCID WINAPI DownlevelLocaleNameToLCID(
__in LPCWSTR lpName,
__in DWORD dwFlags);
LPCWSTR : CONST WCHAR *
WCHAR : wchar_t
어쨌든, 문제 파악은 제대로 된 것 같습니다. 이제 이러한 불일치를 해결하기 위해서 2가지 방식으로 풀어볼 수 있습니다.
1. 헤더 파일 및 소스의 강제 포인터 형변환
예를 들면 더욱 설명이 빠르겠지요.
=== 헤더 파일에 다음의 선언 추가 ===
LCID WINAPI DownlevelLocaleNameToLCID(
__in unsigned short const *lpName,
__in DWORD dwFlags);
=== 소스 파일에서의 강제 형변환 ===
LCID lcid = DownlevelLocaleNameToLCID( (unsigned short*)L"ko-KR", DOWNLEVEL_LOCALE_NAME );
나머지 2개의 함수에 대해서도 위와 같은 방법으로 처리해 줄 수 있습니다.
2. 컴파일러 스위치 사용
프로젝트 대화 상자에서 아래와 같이 "Treat wchar_t as Build-in Type"을 "No (/Zc:wchar_t-)"로 주어서 해결할 수 있습니다. 이렇게 해주면, wchar_t는 하나의 내장 형식이 아닌, typedef을 통해서 unsigned short로 바뀌게 됩니다.
첨부된 파일은 제가 사용한 간단한 예제 프로젝트입니다. 4개의 함수 사용 및 unsigned short로 변환된 헤더 정의를 포함하고 있습니다. Nlsdl.lib와 Nlsdl.dll을 포함시켜 두었는데 모두 x86 버전입니다. iax6/x64 버전으로 테스트하시려면 "Microsoft National Language Support Downlevel APIs 1.0"을 직접 다운로드하면 그에 대한 재배포 파일을 구하실 수 있습니다.