WINAPI宏

为什么要使用WINAPI宏？
    看看上面的举例，在函数前加了一个WINAPI宏。这一点很重要，它直接关系着函数输出什么样子的修饰名，使用WINAPI宏的TestAdd函数，对应的输出修饰名就是“?TestAdd@@YGHHH@Z”。
    为什么要使用WINAPI呢？这牵涉到动态库的另一个特征，调用协议（Calling convention）。如果没有一定的协议，动态库的调用是不可想象的。一般常用的动态库调用协议有：
   __cdecl
   __stdcall 
   __fastcall
这些协议各有各的长处，这里暂不一一描述。上面在谈到解决VB程序调用VC写的动态库时，曾列举两种解决方法，但并不一定可以实现，它还取决于所使用的调用协议。VB所遵循的是PASCAL协议，如果在动态库中没有使用相应的协议，则VB程序执行时就会报告“调用协议错”。而PASCAL协议在VC6中已被废弃，取而代之的是__stdcall，即标准调用协议，这也是大多32位编程语言支持的一种通用协议。在WINDOWS.H中WINAPI也是被定义为__stdcall。这里提议使用WINAPI的理由也就在这，它能够表达出更加多的信息----这样定义的输出函数（的调用协议）和 WINDOWS API函数（的调用协议）一样。
    其它一些使用WINAPI宏的理由：你只要在所定义的函数前加上该宏，就不必要在每次连接时再去理会各种与调用协议相关的设置。况且，你可能并不需要将所有定义的函数都输出，为了提高执行速度，你可能会将没有输出的函数使用__fastcall来定义，为了使用变参，你可能使用__cdecl来定义某些非输出函数,或者诸如此类的理由......需要提醒的是，VC默认的调用协议是__cdecl。如果你在没有修改调用协议的情况下，直接使用DEF文件输出函数，编译连接都不会出错，但是VB调用的时候肯定出错。而如果使用了WINAPI宏，你不必再去理会这些。编译器自动使用WINAPI的定义替代集成环境里的相关设置，这里函数前的说明优先级最高。

    回过头来再看上面有关输出函数的修饰名的讨论，上面提到修饰名与语言有关，另外，它还与调用协议有关。如果需要使用非函数名的名字用来输出，你必须清楚你使用的调用协议及语言种类，也就是你必须清楚修饰名的生成规则，或者你采用一些技巧，让DUMPBIN.EXE工具来帮忙。

使用定义文件和WINAPI宏编写自己的API动态库

Win32 API函数的 WINAPI 宏