为何出现error C2731: 'wWinMain'无法重载的编译错误？

问题说明 #

• 编译错误：error C2731: 'wWinMain' : function cannot be overloaded
• 出错代码行：

  int APIENTRY wWinMain(_In_ HINSTANCE hInst, _In_opt_ HINSTANCE hprevInst, _In_ LPCWSTR lpCmdLine, _In_ int nShowCmd)
  

• 冲突根源：WinBase.h中通过WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)宏（实际展开为((100 == 100))）已声明同名的wWinMain函数，导致重复定义冲突。

解决方案 #

1. 确认项目字符集设置 #

确保项目属性→配置属性→常规→字符集设置为使用 Unicode 字符集，避免字符集不匹配引发的隐式声明问题。

2. 控制WINAPI_FAMILY宏定义 #

在项目属性→配置属性→C/C++→预处理器→预处理器定义中，添加WINAPI_FAMILY=WINAPI_FAMILY_DESKTOP_APP，明确指定仅引入桌面应用API集，减少不必要的函数声明冲突。

3. 严格匹配函数签名 #

确保你的wWinMain签名与系统声明完全一致，正确签名如下：

int APIENTRY wWinMain(
    _In_ HINSTANCE hInstance,
    _In_opt_ HINSTANCE hPrevInstance,
    _In_ LPWSTR lpCmdLine,
    _In_ int nCmdShow
);

注意：系统声明的lpCmdLine是LPWSTR（非const类型），参数名拼写需保持一致（如hPrevInstance、nCmdShow），避免因签名细节差异触发重载冲突。

4. 调整头文件包含顺序 #

确保#include <windows.h>在自定义wWinMain声明之前，避免先声明自定义函数再引入系统头文件导致的重复声明冲突；也可将wWinMain实现放在单独的cpp文件中，隔离头文件影响。

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