Win32：WinMain 应用程序入口点

每个 Windows 程序都包含一个名为 WinMain （使用ANSI 字符集）或 wWinMain （使用Unicode 字符集）的入口点函数。以下代码显示了 wWinMain 的签名：

int WINAPI wWinMain(
  HINSTANCE hInstance,      // 当前实例句柄
  HINSTANCE hPrevInstance,  // 上一个实例句柄（已废弃，始终为 NULL）
  LPWSTR    lpCmdLine,      // 命令行参数（Unicode 字符串）
  int       nCmdShow        // 窗口显示方式
);

参数说明

hInstance：当前应用程序实例的句柄，用于标识应用程序的实例。

hPrevInstance：上一个应用程序实例的句柄，在现代 Windows 中，这个参数始终为 NULL，因为每个应用程序都在独立的地址空间中运行。

lpCmdLine：命令行参数（不包括程序名称），在 WinMain 中是 LPSTR 类型（ANSI 字符串），在 wWinMain 中是 LPWSTR 类型（Unicode 字符串）。

nCmdShow：指定窗口的初始显示方式（如最大化、最小化、正常显示等），常见的值包括：

SW_SHOW：显示窗口。
SW_HIDE：隐藏窗口。
SW_MAXIMIZE：最大化窗口。
SW_MINIMIZE：最小化窗口。

WinMain 或 wWinMain 函数返回一个 int 值，这个返回值通常被称为退出代码。虽然操作系统本身不会直接使用这个返回值，但它可以用于将程序的状态信息传递给其他程序或脚本（例如批处理文件、父进程或其他调用者）。在批处理文件（.bat）或 PowerShell 脚本中，可以通过检查退出代码来决定后续操作，例如：

MyApp.exe
if %errorlevel% == 0 (
    echo Program succeeded!
) else (
    echo Program failed with error code %errorlevel%.
)

请确保声明 wWinMain 函数，如前面的示例所示。

编译器如何知道调用 wWinMain 而不是标准 main 函数？

实际上， (CRT) 的 Microsoft C 运行时库提供了调用 WinMain 或 wWinMain 的 main 实现，默认情况下，链接器会使用 CRT 提供的 main 函数作为入口点，CRT 的 main 函数会在内部调用 wWinMain 或 WinMain。

虽然可以通过链接器选项 /ENTRY 指定自定义入口点函数（例如直接使用 wWinMain 作为入口点），但这通常不推荐，因为如果绕过 CRT，全局和静态对象可能不会正确初始化，如果 CRT 的初始化代码被跳过，程序可能会崩溃或表现出不可预测的行为。

以下代码显示了一个空的 WinMain函数：

int WINAPI wWinMain(
    HINSTANCE hInstance, 
    HINSTANCE hPrevInstance, 
    PWSTR pCmdLine, 
    int nCmdShow) 
{
    return 0;
}

总结

WinMain 函数作为 Windows 应用程序的入口点，承载着程序启动的核心逻辑。理解 WinMain 的工作原理以及它与 CRT（C 运行时库）的关系，是掌握 Windows 编程的重要一步。无论是通过默认的 WinMain 还是自定义的入口点，程序的启动过程都离不开 CRT 的支持。CRT 不仅为我们提供了丰富的运行时功能，还确保了程序的稳定性和兼容性。因此，在大多数情况下，遵循 CRT 的默认行为是最佳实践。在某些特殊场景下，我们可能需要自定义入口点或绕过 CRT 的初始化。这时，务必谨慎行事，确保程序的正确性和稳定性。