如何使用提供的带有 HPP 标头的 DLL 文件？

Question

我目前在尝试与 Verifone PoS 集成时遇到一些问题。

我们合作的银行为我们提供了一个 .dll 文件、一个 .h 文件和一个 .hpp 文件。

我通常是 Java 或 PHP 开发人员，所以在过去的几天里，我浏览了我在网上找到的关于 DLL 文件以及如何使用它们的所有内容，但到目前为止似乎没有一个有效。我遇到了很多错误，其中很多类似于“无效的 dll”。

我在网上发现，除了一个 dll 文件，应该还有一个 .lib 文件。我问过第三方，但显然

没有 .lib 文件。 .dll 文件包含集成所需的所有信息

从他们的图书馆文档中我发现了这个：

提供的二进制文件的形式是一个动态库。就其本质而言，动态库允许更轻松的更新和更正，不需要重新编译或重新链接客户端（调用）代码，只要过程原型（函数参数和返回类型）保持不变。

用于库实现的语言是 C++。

为了访问库二进制文件中实现的功能，提供了一个 C 风格的头文件接口。这包括可调用的函数原型以及结果结构的类型，需要通过这些类型解释返回的数据以对先前访问的功能（特定请求的事务）有意义。

是的，.h 文件仅包含数据类型，而 .hpp 文件包含一些如下所示的声明：

extern "C" __declspec(dllexport) bool doSomething(int param);

在他们的文档中还有一个示例，说明实现的外观（而且相当简单）：

bool someVar = doSomething(1); 

看起来这些函数可以这么简单地调用，但它们不能。如果我尝试这样做，我会收到“未定义函数”（或类似的）错误。

此时似乎唯一起作用的（也许）是使用 LoadLibrary 函数加载 DLL。但除了我尝试调用的任何函数，无论使用任何参数，它都会返回 false，我根本不使用 .hpp 文件似乎有点错误。

所以我们到了。我应该如何解决这个问题？有没有办法加载 DLL 并使用提供的 HPP 文件作为函数定义？如果没有，除了 LoadLibrary + GetProcAddress 组合之外还有其他方法吗？

谢谢！

Answer 1

我假设 dll 是本机 dll，而不是托管程序集 (.net dll)。

通常，dll 作者会在构建系统中添加预处理器定义，例如DLL_EXPORT。因此，如果作者编译 dll，导入库（一个小的 .lib 文件）将包含所有使用 DLL_API 宏的函数。然后作者可以将相同的标头发送给用户。因为该用户不会定义DLL_EXPORT 宏，DLL_API 将解析为 dllimport，这基本上表示在导入库中定义了带注释的函数。

这样的头文件可能看起来像这样（整个#if 条件通常在它自己的头文件中，然后包含在所有导出函数的头文件中）：

#ifdef DLL_EXPORT
#   define DLL_API __declspec(dllexport)
#else
#   define DLL_API __declspec(dllimport)
#endif

extern "C" 
{
    void DLL_API SomeFunction(int x);
    void DLL_API AnotherFunction(int x);
}

如果作者构建项目（在 msvc 中），编译器将生成 dll 文件和一个小的 .lib 文件，即导入库。这个库基本上会做你现在必须做的事情：调用LoadLibrary和GetProcAddress来解析所有被__declspec(dllexport)注解的函数。

以下部分有点推测，我在这里猜测一下。

__declspec(dllimport) 所做的只是告诉消费者这个 dll 包含这些功能。但是链接器必须将声明链接到它的定义（实现），所以函数必须在 compiletime 的某个地方定义。而那个地方就是导入库（.lib）。如果不链接导入库，在构建项目时会出现链接器错误。

这意味着简单地将dllexport 更改为dllimport 不会解决您的问题。如果没有导入库，您唯一的选择是使用 LoadLibrary 手动加载 dll 并搜索每个函数。

如果我是你，我会向作者索要一个使用 dll 的示例项目。 AFAIK，使用本机 dll 的唯一方法是链接到导入库或手动加载所有内容。

从dll手动生成导入库

我已经对此进行了测试以确保它有效。

首先，修复头文件以使用我在上面示例中所做的宏，或者直接使用dllimport。

其次，打开 VS 的开发者命令提示符 并按照this 回答中的步骤操作。确保使用正确的文件名和目标架构（x64 或 x86）。现在你应该有一个 .lib 文件了。

第三，将库添加到您的项目中。

1. 添加 lib 的目录（将其放在项目附近的某个位置，以便您可以使用相对路径）。打开项目属性并按照此图像中的步骤操作： 确保 Configuration 和 Platform 是正确的（您可能希望像图片中那样）。您也可以使用相对路径。点击宏按钮查看所有可用的预定义路径。
2. 将 lib 添加到链接器依赖项中：
3. 将标头放在项目中可以访问的位置。

现在您可以简单地在项目中的任何位置包含标头并使用其中声明的函数。但请注意，dll 文件必须放在LoadLibrary 可以找到它的地方。最好与项目的可执行文件所在的目录相同。

奖励事实

定义文件（.def）其实很简单。我上面的示例代码的 def 文件是：

LIBRARY MyLibrary
EXPORTS
AnotherFunction
SomeFunction

如果我删除声明周围的 extern "C" 块，我的函数名称将被破坏，并且 def 文件如下所示：

LIBRARY MyLibrary
EXPORTS
?AnotherFunction@@YAXH@Z
?SomeFunction@@YAXH@Z

如果您将这些函数放在命名空间中（例如FooSpace），则该命名空间名称也将成为函数名称的一部分：

LIBRARY MyLibrary
EXPORTS
?AnotherFunction@FooSpace@@YAXH@Z
?SomeFunction@FooSpace@@YAXH@Z

请注意，所有extern "C" 实体都将忽略命名空间，这意味着所有extern "C" 函数、变量、类型……都将被放入全局命名空间，无论您是否在命名空间中定义它们。

如果您手动执行，这些也是您必须传递给 GetProcAddress 的名称。