Microsoft MVP성태의 닷넷 이야기
VC++: 25. Microsoft National Language Support Downlevel APIs 1.0 사용 방법 [링크 복사], [링크+제목 복사],
조회: 18611
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
[TestDlg.zip]    

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로 바뀌게 됩니다.
wchar_t 처리
첨부된 파일은 제가 사용한 간단한 예제 프로젝트입니다. 4개의 함수 사용 및 unsigned short로 변환된 헤더 정의를 포함하고 있습니다. Nlsdl.lib와 Nlsdl.dll을 포함시켜 두었는데 모두 x86 버전입니다. iax6/x64 버전으로 테스트하시려면 "Microsoft National Language Support Downlevel APIs 1.0"을 직접 다운로드하면 그에 대한 재배포 파일을 구하실 수 있습니다.






[최초 등록일: ]
[최종 수정일: 6/25/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 16  17  18  19  20  21  22  23  24  25  [26]  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
13166정성태11/20/20228526개발 환경 구성: 651. Windows 사용자 경험으로 WSL 환경에 dotnet 런타임/SDK 설치 방법
13165정성태11/18/20227964개발 환경 구성: 650. Azure - "scm" 프로세스와 엮인 서비스 모음
13164정성태11/18/20229206개발 환경 구성: 649. Azure - 비주얼 스튜디오를 이용한 AppService 원격 디버그 방법
13163정성태11/17/20229484개발 환경 구성: 648. 비주얼 스튜디오에서 안드로이드 기기 인식하는 방법
13162정성태11/15/202210290.NET Framework: 2069. .NET 7 - AOT(ahead-of-time) 컴파일
13161정성태11/14/20229678.NET Framework: 2068. C# - PublishSingleFile로 배포한 이미지의 역어셈블 가능 여부 (난독화 필요성) [4]
13160정성태11/11/20229483.NET Framework: 2067. C# - PublishSingleFile 적용 시 native/managed 모듈 통합 옵션
13159정성태11/10/202212842.NET Framework: 2066. C# - PublishSingleFile과 관련된 옵션 [3]
13158정성태11/9/20228923오류 유형: 826. Workload definition 'wasm-tools' in manifest 'microsoft.net.workload.mono.toolchain' [...] conflicts with manifest 'microsoft.net.workload.mono.toolchain.net7'
13157정성태11/8/20229690.NET Framework: 2065. C# - Mutex의 비동기 버전파일 다운로드1
13156정성태11/7/202210770.NET Framework: 2064. C# - Mutex와 Semaphore/SemaphoreSlim 차이점파일 다운로드1
13155정성태11/4/20229813디버깅 기술: 183. TCP 동시 접속 (연결이 아닌) 시도를 1개로 제한한 서버
13154정성태11/3/20229676.NET Framework: 2063. .NET 5+부터 지원되는 GC.GetGCMemoryInfo파일 다운로드1
13153정성태11/2/202211372.NET Framework: 2062. C# - 코드로 재현하는 소켓 상태(SYN_SENT, SYN_RECV)
13152정성태11/1/202210130.NET Framework: 2061. ASP.NET Core - DI로 추가한 클래스의 초기화 방법 [1]
13151정성태10/31/20229644C/C++: 161. Windows 11 환경에서 raw socket 테스트하는 방법파일 다운로드1
13150정성태10/30/20229217C/C++: 160. Visual Studio 2022로 빌드한 C++ 프로그램을 위한 다른 PC에서 실행하는 방법
13149정성태10/27/20229605오류 유형: 825. C# - CLR ETW 이벤트 수신이 GCHeapStats_V1/V2에 대해 안 되는 문제파일 다운로드1
13148정성태10/26/20228943오류 유형: 824. msbuild 에러 - error NETSDK1005: Assets file '...\project.assets.json' doesn't have a target for 'net5.0'. Ensure that restore has run and that you have included 'net5.0' in the TargetFramew
13147정성태10/25/20228436오류 유형: 823. Visual Studio 2022 - Unable to attach to CoreCLR. The debugger's protocol is incompatible with the debuggee.
13146정성태10/24/20229574.NET Framework: 2060. C# - Java의 Xmx와 유사한 힙 메모리 최댓값 제어 옵션 HeapHardLimit
13145정성태10/21/20229874오류 유형: 822. db2 - Password validation for user db2inst1 failed with rc = -2146500508
13144정성태10/20/20229749.NET Framework: 2059. ClrMD를 이용해 윈도우 환경의 메모리 덤프로부터 닷넷 모듈을 추출하는 방법파일 다운로드1
13143정성태10/19/202210448오류 유형: 821. windbg/sos - Error code - 0x000021BE
13142정성태10/18/202213524도서: 시작하세요! C# 12 프로그래밍
13141정성태10/17/202211119.NET Framework: 2058. [in,out] 배열을 C#에서 C/C++로 넘기는 방법 - 세 번째 이야기파일 다운로드1
... 16  17  18  19  20  21  22  23  24  25  [26]  27  28  29  30  ...