如何使用 __declspec( dllexport/import ) 将 C 结构从 DLL/ 导出/导入到控制台应用程序

Question

这是我第一次处理 DLL。根据 MSDN 文档，我创建了一个头文件 fooExports.h，其中包含根据预处理器定义定义的宏：

#ifdef FOODLL_EXPORTS
    #define FOO_API __declspec( dllexport )
#else
    #define FOO_API __declspec( dllimport )

我的意图是在我的 DLL 实现和控制台应用程序中都使用这个头文件。到目前为止，导入和导出功能工作得很好。当我尝试导出一个已定义的结构时，问题就出现了，我需要该结构作为其中一个导出函数的参数。例如，在前面提到的头文件中我声明了FOO_API void foo( FooParams *args )，args是一个结构体，定义如下：

typedef struct FooParams
{
    char *a;
    char *b;
    void *whatever; //some other type
} FooParams;

这个结构必须在 foo.h 而不是 fooExports.h 中定义。有没有办法导出这个结构而不把它从它的原始头文件中取出（考虑到我想把导出/导入集中在 fooExports.h 中）。 有什么更好的方法来做到这一点？ DLL 都是 C 以及使用它的客户端应用程序。

Answer 1

如果客户端对FooParams 的唯一用途是获取从 DLL 函数返回的指向它的指针并将这些指针传递给其他 DLL 函数，则可以将其设为“不透明类型”：Put

typedef struct FooParams FooParams;

在 fooExports.h 中。 FOO_API 宏不属于该声明。 opaque 类型意味着客户端代码不能：

• 创建FooParams 类型的任何变量（但FooParams * ptr = NULL; 可以）。
• 与FooParams 的任何成员一起做任何事情。
• 找到sizeof(FooParams) - 因此无法正确地为一个或多个FooParams 对象提供malloc 空间。

你也不能#define 对执行上述任何操作的客户端可见的宏。所以你的 DLL 需要有一个或多个“构造函数”或“工厂”函数，可能类似于

FOO_API FooParams* CreateFooParams(const char * input);

定义一个匹配的“析构函数”也是一个好习惯，比如

FOO_API void DestroyFooParams(FooParams * p);

即使定义就像 { free(p); } 一样简单，因为如果在 DLL 内分配的内存被外部代码释放，有时可能会出现问题，反之亦然（因为并非所有 Windows 代码都使用malloc 和 free 的定义相同。

如果这一切都太极端了，唯一的其他选择是将 #include 或 struct 定义放在导出的头文件中，并使其对客户端可见。没有它，除了传递指针之外，任何对FooParams 做某事的尝试都是不可能的，因为编译器不会知道FooParams 中的内容。编译器（与链接器相反）仅从命令行参数和#include-d 文件中获取信息，而不是从库或 DLL 中获取信息。