DLL输入和输出函数—dllinport与dllexport

Microsoft特殊处

dllimport和dllexport存储类修饰符是C语言的Microsoft特殊处扩充。这些修饰显式定义了DLL的客户界面(可执行的文件或另外的DLL)。说明为dllexport的函数消除了一个模块定义(.DLL)文件的需要。你可以为数据和对象使用dllimport和dllexport修饰符。

dllimport和dllexport存储类修饰符必须与扩充的属性语法关键字__declspec一起使用,下面是这样的例子:

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

DllExport void func();

Dllexport int i = 10;

DllExport int j;

DllExport int n;

有关扩充的存储类修饰符的语法的指定信息,参见第3章“说明和类型”中的“扩充的存储类型属性”。

Microsoft特殊处结束

定义和说明

Microsoft特殊处

DLL界面指的是系统中某个程序中输出的所有已知项(函数和数据);也就是所有说明为dllimport或dllexport的所有项。包括在DLL界面中的所有说明必须指定为dllimport或dllexport属性。但该定义只能指定dllexport属性。例如,如下函数定义生成一个编译器错误:

#define DLLImport __declspec(dllimport)

#define DLLExport __declspec(dllexport)

DLLImport int func()/*错误:在定义中禁止dllimport*/

{
return 1;
}

下面代码也产生一个错误:

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

DllImport int i=10; /*错误:这是一个定义*/

但如下是正确的语法:

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

DllExport int i=10; /*正确:这是一个输出定义*/

dllexport的使用隐含一个定义,而dllimport隐含一个说明。你必须对dllexport使用extern关键字强制为一个说明;否则,隐含是一个定义。

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

extern DllImport int k; /*这是正确的并隐含一个说明*/

Dllimport int j;

Microsoft特殊处结束

用dllexport和dllimport定义联编函数

Microsoft特殊处

你可以用dllexport属性定义一个联编函数,在这种情况下,该函数总是被实例化和被输出,无论程序中的任何模块引用该函数。该函数假定是被另一程序输入。

你也可以用dllimport属性说明一个函数为联编函数,在这种情况下,该函数可以被伸展(从属于/Ob(联编)编译器选项规格)但不能被实例化。在特殊情况中,如果一个联编输入的函数的地址被占用,该函数的地址保留在返回的DLL中。这个行为和占用一个非联编输入的函数的地址相同。在联编函数中的静态局部数据和字符串在DLL和象在单个程序中似的客户(也就是,一个没有DLL界面的可执行文件)之间维护相同的标识符。

在进行提供输入的联编函数的练习时要小心,例如,如果你修改DLL,不要假设该客户使用该DLL的改变的版本。为了保证你加载适当的DLL版本,重新建立该DLL的客户。

Microsoft特殊处结束

dllimport/dllexport的规则和限制

Microsoft特殊处

* 如果你说明一个函数没有dllimport或dllexport属性,该函数不认为是DLL界面的部分。因此,该函数的定义必须出现在该模块中或相同程序的另一个模块中。为了使该函数成为DLL界面部分,必须在其它模块中以dllexport说明该函数的定义;否则,在建立客户时产生一个链接器错误。

* 如果你的程序的单个模块包含相同函数的dllimport和dllexport说明,那么dllexport属性的优先级比dllimport属性的优先级高。但编译器产生一个警告。例如:

#define DLLimport __declspec(dllimport)

#define DLLexport __declspec(dllexport)

DllImport void func1(void); DllExport void func1(void);/*警告:dllexport更优先*/

* 你不能用一个以dllimport属性说明的数据对象的地址初始化一个静态数据指针。

例如,如下代码产生一个错误:#define DllImport __declspec(dllimport)#define DllExport __declspec(dllexport) DllImport int i ; . . . int *pi=&i; /* 错误 */ void func2() { static int *pi=&i; /* 错误 */ }

* 用一个dllimport说明的函数的地址初始化一个静态函数指针,设置该指针为该DLL输入形实替换程序(一个转换控制到该函数的代码块)而不是该函数的地址。如下赋值不产生错误消息:

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

DllImport void func1(void)

. . . static void (*pf)(void)=&func1;/* 没有错误 */

void func2()

{

static void (*pf)(void)=&func1;/* 没有错误 */

}

* 因为在一个对象的说明中包括dllexport属性的程序必须提供这个对象的定义,你可以用一个dllexport函数的地址初始化一个全局或局部静态函数指针。类似地,你可以用一个dllexport数据对象的地址初始化一个全局或局部静态数据指针。例如:

#define DllImport __declspec(dllimport)

#define DllExport __declspec(dllexport)

DllImport void func1(void);

DllImport int i;

DllExport void func1(void);

DllExport int i;

. . .

int *pi=&i; /* 正确 */

static void(*pf)(void) = &func1;

/* 正确 */

void func2()
{
static int *pi=i; /* 正确 */
static void (*pf)(void) = &func1; /* 正确 */
}