성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] Roll A Lisp In C - Reading ; https...
[정성태] Java - How to use the Foreign Funct...
[정성태] 제가 큰 실수를 했군요. ^^; Delegate를 통한 Bein...
[정성태] Working with Rust Libraries from C#...
[정성태] Detecting blocking calls using asyn...
[정성태] 아쉽게도, 커뮤니티는 아니고 개인 블로그입니다. ^^
[정성태] 질문이 잘 이해가 안 됩니다. 우선, 해당 소스코드에서 ILis...
[양승조
] var대신 dinamic으로 선언해서 해결은 했습니다. 맞는 해...
[양승조
] 또 막혔습니다. ㅠㅠ var list = props[i].Ge...
[양승조
] 아. 감사합니다. 어제는 안됐던것 같은데....정신을 차려야겠네...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
제니퍼 .NET
닷넷
COM 개체 관련
스크립트
VC++
VS.NET IDE
Windows
Team Foundation Server
디버깅 기술
오류 유형
개발 환경 구성
웹
기타
Linux
Java
DDK
Math
Phone
Graphics
사물인터넷
부모글 보이기/감추기
내용
<div style='display: inline'> <h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>정적 라이브러리 참조 시 "LNK2019 unresolved external symbol '...' referenced in function" 오류 발생 </h1> <p> 우연히 접하게 된 라이브러리 하나가 재미있는 구조로 되어 있습니다. ^^ 기본적으로는 C 정적 라이브러리인데, Win32 DLL로도 컴파일이 가능하게 소스코드가 유연하게 구성되어 있는데요.<br /> <br /> 실제로 간단하게 하나 만들어 보겠습니다. 정적 라이브러리 용도로 Win32 프로젝트를 선택해 다음과 같이 함수 하나를 추가해 둡니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // ================= My.h =============== #pragma once #if defined(_MSC_VER) && defined(_USRDLL) # ifdef LIB_EXPORTS # define LIB_DLLEXTERN __declspec(dllexport) # else # define LIB_DLLEXTERN __declspec(dllimport) # endif #else <span style='color: blue; font-weight: bold'># define LIB_DLLEXTERN</span> #endif #ifdef __cplusplus extern "C" { #endif LIB_DLLEXTERN int MyFunc(int input); #ifdef __cplusplus }; #endif </pre> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // ================= My.c =============== #include "My.h" LIB_DLLEXTERN int MyFunc(int input) { return input + 5; } </pre> <br /> 보시는 바와 같이, Win32 정적 프로젝트(이름: StaticLib)이므로 LIB_DLLEXTERN은 빈 매크로로 설정됩니다. 반면 만약 이 소스코드를 Win32 DLL 프로젝트에 추가해 LIB_DLLEXTERN 상수와 함께 컴파일하면 __declspec(dllexport) 영향으로 MyFunc 함수가 외부로 노출이 가능해집니다.<br /> <br /> 이 함수를 이용하는 Win32 Console EXE 프로젝트를 만들어 테스트 해보면 당연히 잘 컴파일이 됩니다. (정적으로 링크됩니다.)<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > #include "stdafx.h" #include "../StaticLib/My.h" int main() { int result = MyFunc(5); printf("%d\n", result); return 0; } </pre> <br /> <hr style='width: 50%' /><br /> <br /> 문제는, 위의 정적 라이브러리를 Win32 DLL 프로젝트에서 참조할 때 발생합니다. <br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > #include "stdafx.h" #include "Win32Lib.h" #include "../StaticLib/My.h" WIN32LIB_API int fnWin32Lib(void) { int result = MyFunc(5); return result; } </pre> <br /> StaticLib 정적 라이브러리를 추가한 Win32 DLL 프로젝트를 빌드하면 다음과 같은 링크 오류가 발생합니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > Creating library C:\staticlib\x64\Debug\Win32Lib.lib and object C:\staticlib\x64\Debug\Win32Lib.exp Win32Lib.obj : error LNK2019: unresolved external symbol __imp_MyFunc referenced in function "int __cdecl fnWin32Lib(void)" (?fnWin32Lib@@YAHXZ) C:\staticlib\x64\Debug\Win32Lib.dll : fatal error LNK1120: 1 unresolved externals </pre> <br /> 문제를 간단히 했으니 쉽게 유추할 수 있지만, 수많은 소스 코드 파일을 담은 3rd-party 라이브러리를 정적 링크할 때 저런 오류가 나오면 도대체 뭐가 잘못된 것인지 ^^; 헤맬 수밖에 없습니다.<br /> <br /> 원인은 간단합니다. My.h 헤더 파일을 include한 Win32 DLL 프로젝트는 _USRDLL 상수가 정의되어 있으므로 __declspec(dllimport) 구문이 정의되어 버립니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > #pragma once #if defined(_MSC_VER) && defined(_USRDLL) # ifdef LIB_EXPORTS # define LIB_DLLEXTERN __declspec(dllexport) # else <span style='color: blue; font-weight: bold'># define LIB_DLLEXTERN __declspec(dllimport)</span> # endif #else # define LIB_DLLEXTERN #endif #ifdef __cplusplus extern "C" { #endif <span style='color: blue; font-weight: bold'>LIB_DLLEXTERN</span> int MyFunc(int input); #ifdef __cplusplus }; #endif </pre> <br /> 따라서, DLL 프로젝트 측에서는 "__declspec(dllimport) int MyFunc(int input);" 시그니처를 가진 함수를 찾으려고 시도하지만 링커는 정적 라이브러리 파일(.lib)로부터 그 함수를 찾을 수 없으므로 LNK2019 오류를 내뱉는 것입니다.<br /> <br /> 문제의 원인을 좀 더 자세히 설명해보면!<br /> <br /> "__declspec(dllimport)"로 인해 calling convention이 바뀌는 것은 아닙니다. 단지 dllimport가 지정된 경우 Visual C++ 컴파일러는 그것이 DLL로부터 export된 함수라고 가정하고 DLL 컴파일 시에 생성된 Import Library의 정보를 바탕으로 링크를 시도하는데 이때 해당 .lib 파일에 정의된 이름이 "__imp_[function]" 과 같은 식으로 정의됩니다. 하지만, 우리가 제공했던 .lib 파일은 DLL의 Import Lib 파일이 아닌 순수 정적 링크를 위한 .lib 파일이기 때문에 __imp_.... 식의 이름을 포함하고 있지 않아 LNK2019 오류로 이어진 것입니다.<br /> <br /> 어찌 보면, 정적 라이브러리 파일과 (DLL의) Import 라이브러리 파일의 확장자를 동일하게 해버려서 온 혼란의 하나겠지요!<br /> <br /> 해결 방법은, 추가하려는 정적 파일의 헤더 파일을 수정하거나... 아니면 다음과 같이 임시로 _USRDLL 상수를 해제해 버리면 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > #include "stdafx.h" #include "Win32Lib.h" <span style='color: blue; font-weight: bold'>#undef _USRDLL</span> #include "../StaticLib/My.h" WIN32LIB_API int fnWin32Lib(void) { int result = MyFunc(5); return result; } </pre> <br /> (<a target='tab' href='http://www.sysnet.pe.kr/bbs/DownloadAttachment.aspx?fid=990&boardid=331301885'>첨부한 파일은 이 글의 재현 코드</a>입니다.)<br /> </p><br /> <br /><hr /><span style='color: Maroon'>[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]</span> </div>
첨부파일
스팸 방지용 인증 번호
1895
(왼쪽의 숫자를 입력해야 합니다.)