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

忘是亡心i 2022-08-27 10:58 254阅读 0赞

## Step by Step: Calling C++ DLLs from VC++ and VB  ##

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

### 作者 Hans Dietrich翻译烟灰 ###

## 介绍 ##

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

<table style="WIDTH: 70%; mso-cellspacing: 0cm; mso-padding-alt: 3.75pt 3.75pt 3.75pt 3.75pt"> 
 <tbody> 
 <tr> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 20%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> Part 1 </td> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 80%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> 从VC++应用程序调用C++ DLL的函数 </td> 
 </tr> 
 <tr> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 80%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> 从VC++应用程序调用C++ DLL的类 </td> 
 </tr> 
 <tr> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 20%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> <a href="http://www.codeproject.com/dll/XDllPt2.asp" rel="nofollow">Part 2</a> </td> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 80%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> 从VB应用程序调用C++ DLL的函数 </td> 
 </tr> 
 <tr> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 20%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> <a href="http://www.codeproject.com/dll/XDllPt3.asp" rel="nofollow">Part 3</a> </td> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 80%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> 从VB应用程序调用C++ DLL的类 </td> 
 </tr> 
 <tr> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 20%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> <a href="http://www.codeproject.com/dll/XDllPt4.asp" rel="nofollow">Part 4</a> </td> 
 <td style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; WIDTH: 80%; PADDING-TOP: 3.75pt; BORDER-BOTTOM: #d4d0c8; BACKGROUND-COLOR: transparent"> 从VC++应用程序动态的调用C++ DLL的函数 </td> 
 </tr> 
 </tbody> 
</table>

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

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

###  ###

###     ###

###  ###

### 第一步 ###

打开 Visual Studio 然后选择 File | New菜单项:![XDllPt1_1.jpg][]  
选择**Win32 Dynamic Link Library,** 输入工程名, 敲 OK.  
![XDllPt1_2.jpg][]  
选择**A DLL that exports some symbols**并单击Finish.在File View里你会看到如下的工程文件:  
![XDllPt1_3.jpg][]

###  ###

### 第二步 ###

在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 int fnTest(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 int fnTest(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,** 你将看到工程选项 : ![XDllPt1_4.jpg][]

当然了,这个办法是可行的. 但是它却容易让人忽计,并且可能导致维护上的麻烦. 我比较喜欢清楚明白的定义`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工程的目录)![XDllPt1_5.jpg][]

> **提示这样做实际上是假设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 \_\_cdecl fnTest(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里边去: ![XDllPt1_6.jpg][]  
  
\----------------------------------------------

###  ###

### 第八步 ###

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

### 第九步 ###

接下来,可以放一个断点到`OnInitDialog()`函数里去, 点 GO(F5)调试运行:

![XDllPt1_7.jpg][]

可以看到,`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文件的路径.   
![XDllPt1_9.jpg][]

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

哪种方法更好一点呢?这取决于你的开发环境. 第一种方法要求整个工程要共享的设置目录路径, 并且所有要求所有的开发者的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 int fnTest(void);

这样做,保证了当工程包含DLL的头文件时, 它会自动的把DLL 的lib链接进去,我们可以从VS的OUTPUT窗口看到\#pragma message给我们的传达的"automatic link to Test.lib"这个消息.  
  
  
  
（PS:原文在这里 [http://www.codeproject.com/dll/XDllPt1.asp][http_www.codeproject.com_dll_XDllPt1.asp]  
demo也可以在这里下载到  
）

[XDllPt1_1.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_1.jpg
[XDllPt1_2.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_2.jpg
[XDllPt1_3.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_3.jpg
[XDllPt1_4.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_4.jpg
[XDllPt1_5.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_5.jpg
[XDllPt1_6.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_6.jpg
[XDllPt1_7.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_7.jpg
[XDllPt1_9.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_9.jpg
[XDllPt1_10.jpg]: http://www.codeproject.com/dll/XDllPt1/XDllPt1_10.jpg
[http_www.codeproject.com_dll_XDllPt1.asp]: http://www.codeproject.com/dll/XDllPt1.asp