VS中DLL的导出宏的定义和头文件的位置导致的两类编译错误总结

最新推荐文章于 2024-10-14 11:33:39 发布

原创

最新推荐文章于 2024-10-14 11:33:39 发布 · 2.7k 阅读

3 ·

CC 4.0 BY-SA版权

在Visual Studio中创建动态链接库DLL时，正确使用导出宏API_EXPORT至关重要。宏定义应置于包含接口头文件之前，以确保接口函数作为导出函数编译。预编译头文件stdafx.h的存在可能导致混淆，产生编译错误。当遇到错误时，不仅要关注错误信息，还要注意伴随的warning和note，因为它们可能揭示问题的关键。正确安排API_EXPORT的定义顺序能避免编译失败，确保DLL接口正常导出。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一般地，我们在新建一个win32的动态链接库（DLL）时，会采取如下的方式的来编写导出接口文件（.h）。

#pragma once

#ifndef API_EXPORT
#define DECL_API extern "C" __declspec(dllimport)
#else
#define DECL_API extern "C" __declspec(dllexport)
#endif

DECL_API int Add(int a, int b);

如上代码，主要使用了一组预编译宏。这样设计的好处是，可以复用这个头文件。复用的方法是：

1）在客户端，正常包含该头文件即可。不要定义“API_EXPORT”，这个宏。这样客户端编译时将把所有接口看作导入函数。

2）在DLL端，接口函数的实现文件中（.cpp），需要定义宏“API_EXPORT”。这样，DLL编译时将把接口函数当作导出函数。

问题：

在接口函数的实现文件中，需要非常小心宏“API_EXPORT”的定义行与接口头文件包含代码行的位置关系。否则容易导致编译错误，特别是用VS的预编译头文件后。

举例：

用VS2015（其他版本也可以）新建一个名为“Export”的win32 DLL工程（其他默认）。它将生成几个文件，其中关键的文件有：