一步一步教你用VC和VB调用C++ DLL

Step by Step: Calling C++ DLLs from VC++ and VB<?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />

一步一步教你用VC和VB调用C++ DLL.

作者 Hans Dietrich    翻译烟灰

介绍

本系列教程讨论了普通情况下4种使用DLL的方法

Part 1	从VC++应用程序调用C++ DLL的函数
从VC++应用程序调用C++ DLL的类
Part 2	从VB应用程序调用C++ DLL的函数
Part 3	从VB应用程序调用C++ DLL的类
Part 4	从VC++应用程序动态的调用C++ DLL的函数

从VC++应用程序调用C++ DLL的函数

Visual Studio 6 使创建包含函数或类的动态连接库(DLL) 变得非常容易.

第一步

打开 Visual Studio 然后选择 File | New菜单项:


选择 Win32 Dynamic Link Library, 输入工程名, 敲 OK.



选择 A DLL that exports some symbols  并单击Finish.在File View里你会看到如下的工程文件:

第二步

在Test.cpp里,你将看到如下代码:// Test.cpp : Defines the entry point for the DLL application.//#include "stdafx.h"#include "Test.h"

BOOL APIENTRY DllMain( HANDLE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved)
{
    switch (ul_reason_for_call)
    {
        case DLL_PROCESS_ATTACH:
        case DLL_THREAD_ATTACH:
        case DLL_THREAD_DETACH:
        case DLL_PROCESS_DETACH:
            break;
    }
    return TRUE;
}

// This is an example of an exported variable
TEST_API int nTest=0;

// This is an example of an exported function.
TEST_API intfnTest(void)
{
    return 42;
}

// This is the constructor of a class that has been exported.// see Test.h for the class definition
CTest::CTest()
{
    return;
}Test.cpp 包含了

fnTest 和 CTest::CTest

.如果你现在编译Test.dll, 你将会得到一个可以被其他VC++应用程序直接调用的DLL.   允许其他VC++程序调用的关键机制?( key mechanism)就包含在 Test.h中:

// The following ifdef block is the standard way of creating macros// which make exporting from a DLL simpler. All files within this DLL// are compiled with the TEST_EXPORTS symbol defined on the command line.// This symbol should not be defined on any project that uses this DLL.// This way any other project whose source files include this file see // TEST_API functions as being imported from a DLL, whereas this DLL// sees symbols defined with this macro as being exported.#ifdef TEST_EXPORTS#define TEST_API __declspec(dllexport)#else#define TEST_API __declspec(dllimport)#endif// This class is exported from the Test.dllclass TEST_API CTest
{
public:
    CTest(void);
    // TODO: add your methods here.
};

extern TEST_API int nTest;

TEST_API intfnTest(void);

这里面发生了什么? #ifdef TEST_EXPORTS是什么意思?

TEST_EXPORTS

又是在哪定义的?

TEST_EXPORTS

如果被定义, 那么

TEST_API

将会被定义为 __declspec(dllexport) (DLL导出), 否则,将会被定义为__declspec(dllimport)(DLL导入).  这将影响到后边定义的Ctest类是导出类还是导入类. 这意味着如果我们需要导出的时候,我们就得定义

TEST_EXPORTS.

当一个VC++应用程序要访问这个DLL的时候,可以将Test.lib链接进去,它包含了DLL的导出符号.

第三步

TEST_EXPORTS

在哪里被定义了呢? DLL wizard干了一件我讨厌的事,它把

TEST_EXPORTS

放到了命令行里.  选择 Project | Settings | C/C++ | General, 你将看到工程选项:


当然了,这个办法是可行的. 但是它却容易让人忽计,并且可能导致维护上的麻烦. 我比较喜欢清楚明白的定义

TEST_EXPORTS

: 从项目选项里边去掉/D "TEST_EXPORTS",然后在Test.cpp 里来定义它:
// Test.cpp : Defines the entry point for the DLL application.
//

#include "stdafx.h"
#define TEST_EXPORTS                     // <===  ADD THIS LINE
#include "Test.h"

BOOL APIENTRY DllMain( HANDLE hModule,
                       DWORD  ul_reason_for_call,
                       LPVOID lpReserved)
{
.
.
.
注意 #define TEST_EXPORTS 在 #include "Test.h"前边. 所以,它定义要在头文件里.现在,可以像先前那样重新编译我们的Test.dll,  我们将得到一个可以被其他VC应用程序所调用的DLL.

 

第四步

我们如何调用DLL里的函数呢? 举个例子吧, 我用VS创建一个示例.  选MFC AppWizard (exe),输入项目名字,然后点OK. 选择基于对话框. 然后点Finish.  打开 XXXDlg.cpp(XXX是你的工程名字.) 找到

OnInitDialog()

成员函数, 敲进去如下的代码:    .
    .
    .
    // Set the icon for this dialog.  The framework does this automatically
    //  when the application's main window is not a dialog
    SetIcon(m_hIcon, TRUE);            // Set big icon
    SetIcon(m_hIcon, FALSE);        // Set small icon
    
    // code to test Test.dll function:
    int n =fnTest();                    // <=== ADD THIS LINE

    // code to test the CTest class:
    CTest test;                          // <=== ADD THIS LINE
    
    return TRUE;  // return TRUE  unless you set the focus to a control
}

第五步

我们还没写完代码呢, 现在要把 Test.h这个DLL的头文件包含进去:

// TestExeDlg.cpp : implementation file//#include "stdafx.h"#include "TestExe.h"#include "TestExeDlg.h"#include "Test.h"                        // <=== ADD THIS LINE
.
.
.

第六步

如果你想赶时间做一个演示的话, 你可能会尝试只是拷贝DLL的 test.h 到你的项目目录里去,那么编译器会找到它.   但是当项目很大的时候,这可不是个好主意, 因为当你更新你的DLL文件时,可能会遇上危险.比如忘了拷贝它到你的exe的目录中去.   这里有个简单的方法来解决这个问题 : 选择Project | Settings | C/C++ | Settings | Preprocessor, 并且添加Additional include directories: (DLL工程的目录)


提示  这样做实际上是假设DLL项目和EXE项目拥有同一个项目目录.

现在当我编译的时候, 我得到了一个 linker errors!!
Deleting intermediate files and output files for project 'TestExe - Win32 Debug'.
--------------------Configuration: TestExe - Win32 Debug--------------------
Compiling resources...
Compiling...
StdAfx.cpp
Compiling...
TestExe.cpp
TestExeDlg.cpp
Generating Code...
Linking...
TestExeDlg.obj : error LNK2001: unresolved external symbol "__declspec(dllimport)
public: __thiscall CTest::CTest(void)" (__imp_??0CTest@@QAE@XZ)
TestExeDlg.obj : error LNK2001: unresolved external symbol "__declspec(dllimport)
int __cdeclfnTest(void)" (__imp_?fnTest@@YAHXZ)
Debug/TestExe.exe : fatal error LNK1120: 2 unresolved externals
Error executing link.exe.

TestExe.exe - 3 error(s), 0 warning(s)

第七步

虽然我已经告诉编译器DLL符号啦,但是链接器还不知道. 所以我们必须告诉链接器.. 选择Project | Settings | Link,把DLL的lib文件加到Object/library modules里边去:


----------------------------------------------

第八步

好啦,现在编译通过. 在我们运行程序前,别忘了一件事: 把Test.dll  拷贝到EXE的目录里去.

第九步

接下来,可以放一个 断点到

OnInitDialog()

函数里去, 点 GO(F5)调试运行:



可以看到,

fnTest

返回了42, 和我们预测的一样.

CTest

类也可以用类似的方法来测试.

要点.

VS的工程向导为我们创建VC++DLL提供了很好的开始.

函数,类, 和变量 可以从DLL中导出.

使用  #define 预处理器定义, 一个头文件将可以被DLL 和应用程序共同使用.

DLL导出它的符号,并且应用程序导入这个DLL符号.  当编译应用程序时,编译器通过头文件看到的DLL符号, 当链接应用程序时, 链接器通过导入库(Test.lib)看到DLL符号.

当执行应用程序时,DLL必须放到和EXE相同的目录中去. DLL也可以放到 windows或者system目录中,这样也是可行的, 但是它经常引起某些问题, 所以应该避免这样使用

注释:

再实际工作中,我很少用到 第七步中的方法. 这样做的话,在大的工程中,DLL和Lib文件将经常变得很难管理.我们会想到要建立一个lib目录和一个 bin目录,在这里边放进去所有我们要使用的lib文件 , dll文件 和exe文件. 如果这样做的话,我们怎么告诉链接器找到lib文件呢? 有两种方法来做:
1.  选择Tools | Options | Directories and set Show directories for 为"Library files". 在下边添加上我们工程所使用的Lib文件的路径.



2. 另一种办法是,选择 Project | Settings | Link, 选category为 Input ,在下边的 Additional library path 筐里输入工程使用的lib文件的所在路径.



哪种方法更好一点呢?这取决于你的开发环境. 第一种方法要求整个工程要共享的设置目录路径, 并且所有要求所有的开发者的VS都必须设置到这些路径.
第二种方法允许每个工程定制自己的路径,并且在工程中被储存,如果开发者的计算机上存放了同样的目录,那么每个开发者都可以签出工程并且设计. ,这样可以避免在每台机器上都去设置同样的路径.
 

到现在,我还没有说怎样指定要使用的LIB文件, 我的办法是在DLL的Test.h中添加两行,现在它看起来像下边的样子:
 #ifdef TEST_EXPORTS    #define TEST_API __declspec(dllexport)#else    #define TEST_API __declspec(dllimport)    #pragma message("automatic link to Test.lib")   // <== add this line    #pragma comment(lib, "Test.lib")                // <== add this line#endif// This class is exported from the Test.dllclass TEST_API CTest
{
public:
    CTest(void);
};

extern TEST_API int nTest;

TEST_API intfnTest(void);
这样做,保证了当工程包含DLL的头文件时, 它会自动的把DLL 的lib链接进去,我们可以从VS的OUTPUT窗口看到#pragma message给我们的传达的"automatic link to Test.lib"这个消息.

（PS:原文在这里 http://www.codeproject.com/dll/XDllPt1.asp 
demo也可以在这里下载到
）