为何此MASM汇编示例代码可编译但无法链接，报LNK2019 _MessageBeep未解析错误

问题根因 #

你遇到的链接错误是x86架构下stdcall调用约定的名称修饰规则导致的符号不匹配：

• 32位Windows API遵循stdcall调用约定，符号会被修饰为_函数名@参数总字节数的格式，MessageBeep只有1个4字节的UINT类型参数，因此user32.lib中导出的正确符号是_MessageBeep@4
• 你仅用EXTRN MessageBeep:PROC声明外部函数，没有指定函数的参数长度，MASM不会自动为符号添加@4后缀，生成的obj文件中需要导入的符号是_MessageBeep，和库中实际的符号无法匹配，就抛出了LNK2019错误。

解决方法 #

提供两种可行的修改方案，二选一即可：

方案1：直接使用完整修饰名

修改汇编代码中外部函数声明和调用的部分：

; 把原来的EXTRN MessageBeep:PROC 替换为下面这行
EXTRN _MessageBeep@4:PROC

; 调用的地方也替换为完整符号
call _MessageBeep@4

修改完成后重新编译链接即可正常生成可执行文件。

方案2：使用PROTO伪指令自动处理名称修饰

用MASM原生的PROTO声明函数，让汇编器自动处理stdcall的名称修饰规则，不用手动写修饰后缀：

; 替换原来的EXTRN声明
MessageBeep PROTO STDCALL :DWORD

; 调用的时候可以直接用CALL，也可以用INVOKE更方便
INVOKE MessageBeep, 0FFFFFFFFh

这种写法可读性更高，也不容易写错修饰后缀，更推荐使用。

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