如何使用 cl 编译 Window API 程序？

Question

我正在尝试使用 Windows SDK 命令提示符编译一个简单的 C Windows API 程序。

这里是节目的摘录：

#include <Windows.h>
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)
{

[...]

    RegisterClass(&wc);
    hwnd = CreateWindow("test", NULL, 0, 0, 0, 0, 0, NULL, NULL, hInstance, NULL);

[...]

当我使用它编译时

cl test.c

在 Windows SDK 命令提示符中，它给了我很多这样的链接器错误：

test.obj : error LNK2019: unresolved external symbol __imp_CreateWindowExA referenced in function WinMain
test.obj : error LNK2019: unresolved external symbol __imp_RegisterClassA referenced in function WinMain

Answer 1

至少有两个问题。

1. 链接器告诉您有一个“未解析的外部符号”。这意味着它找不到您尝试调用的函数的定义。在这种情况下，有两个这样的未定义函数：CreateWindowExA 和 RegisterClassA。

   显然，这些函数的定义不在您的代码中，而是在 Windows API 库中，因此您需要通知链接器它在哪里可以找到这些定义。

   SDK 带有存根 (*.lib) 文件，其中包含链接器使用的信息，以便它可以在运行时在 Windows DLL 中找到正确的函数定义。您需要指示链接器在哪里可以找到那些 *.lib 文件。

   这样做有几种不同的策略：

   1. 简单（尽管不可移植）的方法是在源文件中插入#pragma 语句，指示编译器留下链接器可识别的注释。例如，

      #pragma comment(lib, "user32")
      

      自动链接到user32.lib，这是user32.dll 的存根文件。

   2. 或者，您可以将命令行上的参数传递给cl.exe。但是，如果您不使用 MSBuild 或某种 make 文件，这会很快变得非常复杂。在这种情况下，您需要将命令行修改为（至少）：

      cl test.c user32.lib
      

   这两个选项自然假定您的 Windows SDK 目录已添加到路径中。我很确定安装程序会自动为您执行此操作，但我并不肯定。如果没有，或者您已从路径中删除了这些文件，则需要在命令行上使用 *.lib 文件的完全限定路径。

   阅读the documentation for the possible compiler options 是一个不错的起点。或者更好的是，如果您不熟悉 Windows 编程，可以使用 Visual Studio 等环境自动为您整合所有这些内容。一旦你了解了发生了什么，看看 Visual Studio 运行的命令行是什么，并一点一点地剖析它。

2. 下一个问题是您正在编译没有定义Unicode，并且因为ANSI is the default，Windows头文件中的所有宏都解析为调用所有A后缀的版本SDK 功能。这可能不是你想要的。十多年来，Windows 已经完全采用 Unicode，所有新应用程序都应构建为 Unicode。 Unicode 版本在其名称后附加了 W 后缀。

   同样，您可以通过向源文件添加行或向命令行添加参数来显式指示编译器使用 Unicode 构建。

   在这种情况下，最简单的方法可能就是添加

    #define UNICODE
   

   到源文件的顶部之前 #include <windows.h>。正如我们在上面看到的，在 Visual Studio 环境中，UNICODE 会自动为您定义，除非您明确更改项目设置以定位其他内容。

Answer 2

这些函数存在于 user32.lib 中。您需要将其提供给 cl 工具。

cl test.c ""C:\Program Files\Microsoft SDKs\Windows\v6.0A\Lib\user32.lib"
Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 15.00.307
Copyright (C) Microsoft Corporation.  All rights reserved.

test.c
Microsoft (R) Incremental Linker Version 9.00.30729.01
Copyright (C) Microsoft Corporation.  All rights reserved.

/out:test.exe
test.obj
"C:\Program Files\Microsoft SDKs\Windows\v6.0A\Lib\user32.lib"