[C++ DLL] Visual Studio C++ DLL 생성하기 (예제 포함)

지난 포스팅에서 외부 라이브러리 및 동적/정적 링킹에 대한 이론적인 소개를 했었습니다.

[C++ DLL] 외부 라이브러리에 대한 이해

[C++ DLL] 외부 라이브러리에 대한 이해

이번 포스팅에서는 Visual Studio C++ DLL 프로젝트를 통해 dll을 어떻게 생성하고 불러오는지 알아보겠습니다. 본문의 예제에서는 사칙 연산 함수를 dll에 구현하겠습니다.

C++ DLL 프로젝트 생성

Visual Studio 실행 후 Visual C++ > DLL(동적 연결 라이브러리) 프로젝트를 생성합니다.

DLL 프로젝트 생성

프로젝트 생성 후 MyMath.h 및 MyMath.cpp 파일을 추가합니다.

MyMath.h 추가

MyMath.cpp 추가

그리고 MyMath.h에 다음과 같이 선언합니다.

#pragma once

#ifdef CREATEDLL_EXPORTS
#define MYMATH_DECLSPEC __declspec(dllexport)
#else
#define MYMATH_DECLSPEC __declspec(dllimport)
#endif

extern "C" MYMATH_DECLSPEC double Sum(double a, double b);
extern "C" MYMATH_DECLSPEC double Sub(double a, double b);
extern "C" MYMATH_DECLSPEC double Mul(double a, double b);
extern "C" MYMATH_DECLSPEC double Div(double a, double b);

MyMath.cpp에는 다음과 같이 구현합니다. 아주 간단하죠?

#include "MyMath.h"

double Sum(double a, double b) {
	return a + b;
}

double Sub(double a, double b) {
	return a - b;
}

double Mul(double a, double b) {
	return a * b;
}

double Div(double a, double b) {
	return a / b;
}

여기서 세 가지 설명드릴 내용이 있습니다.

전처리기 CREATEDLL_EXPORTS?

#ifdef CREATEDLL_EXPORTS는 CREATEDLL_EXPORTS라는 전처리기가 정의되어있는지 확인하는 조건문입니다. 만약 정의되어 있다면, MYMATH_DECLSPEC은 __declspec(dllexport)를 의미합니다. 정의되어 있지 않다면, MYMATH_DECLSPEC은 __declspec(dllimport)를 의미합니다.

전처리기가 정의되어 있는지 확인하기 위해서는 프로젝트 설정 > C/C++ > 전처리기 > 전처리기 정의에서 확인할 수 있습니다. 여기에서 사용자가 임의로 CREATEDLL_EXPORTS 이름을 변경하고, 전처리기 조건문의 전처리기를 변경해도 상관없습니다.

전처리기 정의 화면

왜 이렇게 구분 지었냐면, 동일한 *.h 파일을 dll 생성 프로젝트와 dll 호출 프로젝트에서 사용하기 위해서입니다. 만약, dll 생성 프로젝트 전용 *.h 파일과 dll 호출 프로젝트 전용 *.h 파일을 따로 관리한다면 귀찮아지겠죠? 그래서 이렇게 전처리기 정의를 추가하여 하나의 파일로 관리가 가능해집니다.

__declspec(dllexport)와 __declspec(dllimport) 키워드?

그럼 __declspec(dllexport)와 __declspec(dllimport)는 무엇일까요?

__declspec(dllexport) 키워드가 붙은 함수는 DLL 외부로 노출됩니다. 즉, DLL을 사용하여 __declspec(dllexport) 키워드가 붙은 함수를 호출할 수 있다는 의미입니다. 이와 반대로, 해당 키워드가 없는 함수는 정의되어 있어도 DLL 외부에서 호출할 수 없습니다.

__declspec(dllimport) 키워드는 DLL에 정의된 함수를 호출하기 위해 사용됩니다. 즉, DLL에서 __declspec(dllexport)로 정의된 함수를 __declspec(dllimport)로 호출한다는 것이죠.

extern "C" 키워드?

extern "C" 키워드를 설명하기에 앞서, 네임 맹글링(Name Mangling)에 대해 설명하지 않을 수 없는데요. 네임 맹글링이란, 컴파일러가 함수의 이름을 일정한 규칙을 가지고 변형하는 것을 의미합니다. C++에서는 C와는 다르게 함수 오버로딩을 지원하는데요. 즉, 동일한 함수의 이름이라도 매개변수에 따라 링커는 다르게 구분하게 됩니다. 따라서 같은 이름의 함수가 여러 개 존재할 때 어떤 함수를 호출할지 구분해서 링크하기 위해 컴파일러가 이름을 변형하게 됩니다. 그래서 맹글링이 적용됩니다.

그런데 DLL을 사용하여 명시적 링킹(Explicit Linking)을 할 경우 호출할 함수의 이름을 알아야 하는데요. 함수의 이름이 DLL로 생성되면서 맹글링 되면 호출하기가 어렵겠죠? 그래서 extern "C" 키워드를 붙여 네임 맹글링을 수행하지 않겠다고 정의하는 것입니다.

DLL을 탐색할 수 있는 Dependency Walker 프로그램을 사용하여, extern "C" 키워드 유무에 따른 함수 이름을 잠시 살펴보겠습니다.

extern "C" 키워드를 사용하여 DLL을 생성하면, Sum, Sub, Mul, Div라는 함수 이름이 보입니다(이후 예제에서 생성할 함수 이름입니다). 그리고 앞 열에 C언어라고 표시됩니다.

extern "C" 키워드를 사용한 DLL

extern "C" 키워드를 사용하지 않고 DLL을 생성하면, 특수문자와 대문자 알파벳이 섞인 함수 이름이 보입니다. 그리고 앞 열에 C++ 언어라고 표시됩니다.

extern "C" 키워드를 사용하지 않은 DLL

이처럼, extern "C" 키워드를 통해 네임 맹글링을 수행하지 않을 수 있고, 명시적 링킹으로 특정 함수 호출이 가능해집니다.

빌드하여 DLL 생성하기

이제 프로젝트를 빌드하겠습니다. 빌드 후 *.dll 및 *.lib 파일이 생성되었습니다. 향후 이 파일과 *.h 파일을 같이 배포하면, 사용자가 프로젝트에 dll을 불러와 사용할 수 있습니다.

생성된 dll 및 lib 파일

본문의 dll 생성 프로젝트 예제 코드를 첨부했습니다. 추후 생성된 dll을 어떻게 프로젝트에 불러와 사용하는지 이어서 소개하겠습니다.

ExamDLL.zip

0.01MB