函数签名中的WINAPI引发编译及调用错误的原因与解决方法

问题1：添加WINAPI修饰后编译通过，但Excel调用返回无效数据 #

原因 #

• WINAPI对应__stdcall调用约定，C++编译器会对这类函数进行名称修饰（比如square_winapi会变成_square_winapi@4），但Excel是按原函数名查找入口的，找不到正确的函数地址就会返回无效数据。
• 另外，若函数的参数、返回值类型不匹配Excel/VBA支持的基础类型（比如用float而非double），也会导致返回值异常。

解决办法 #

1. 统一调用约定并导出正确函数名
   两种可选方案：
   • 保留WINAPI，用extern "C"避免C++名称修饰，同时用__declspec(dllexport)导出函数：

     // SquareLib.h
     #ifdef SQUARELIB_EXPORTS
     #define SQUARELIB_API __declspec(dllexport)
     #else
     #define SQUARELIB_API __declspec(dllimport)
     #endif
     
     extern "C" {
         SQUARELIB_API double WINAPI square_winapi(double num);
     }
     

   • 改用Excel默认支持的__cdecl调用约定，去掉WINAPI修饰，同样用extern "C"导出：

     extern "C" {
         SQUARELIB_API double __cdecl square_double(double num);
     }
     

2. 校验类型兼容性
   确保函数参数和返回值均为Excel可识别的基础类型，比如用double代替float，用long代替自定义枚举或结构体。

问题2：保留square_winapi时C++客户端编译出现C2146和C4430错误 #

原因 #

• C2146是语法错误，通常是函数声明缺少必要元素（比如分号、类型声明）；C4430是缺少类型说明符（C++禁用默认int类型）。核心问题是头文件中函数声明不规范：
  • 未用extern "C"包裹，导致C客户端按C名称修饰查找函数，与DLL中C风格导出的函数不匹配。
  • 导出宏或调用约定的定义缺失，导致函数声明语法不完整。

解决办法 #

1. 规范头文件声明
   确保头文件中所有导出函数用extern "C"包裹，同时正确定义导出宏：

   // SquareLib.h
   #ifdef SQUARELIB_EXPORTS
   #define SQUARELIB_API __declspec(dllexport)
   #else
   #define SQUARELIB_API __declspec(dllimport)
   #endif
   
   extern "C" {
       SQUARELIB_API double WINAPI square_winapi(double num);
       SQUARELIB_API double __cdecl square_double(double num);
   }
   

2. 匹配客户端项目设置
   客户端项目中需包含正确的头文件，且项目的调用约定设置要与DLL一致（比如DLL用__stdcall，客户端也要在项目属性的“C/C++ -> 高级 -> 调用约定”中选择__stdcall）。
3. 排查语法细节
   检查客户端调用函数的代码，确认参数传递正确、变量已声明、返回值接收逻辑无误。

内容的提问来源于stack exchange，提问作者Jack J