使用 Windows 标头

  • 项目

使用 Windows API 的头文件，可以创建 32 位和 64 位应用程序。 它们包括 API 的 Unicode 和 ANSI 版本的声明。 有关详细信息，请参阅 Windows API 中的 Unicode。 它们使用 数据类型 ，使你能够从单个源代码库生成应用程序的 32 位和 64 位版本。 有关详细信息，请参阅 为 64 位 Windows 做好准备。 其他功能包括 标头注释 和 STRICT 类型检查。

Visual C++ 和 Windows 头文件

Microsoft Visual C++包括发布 Visual C++ 时当前 Windows 头文件的副本。 因此，如果从 SDK 安装更新的头文件，则最终可能会在计算机上获得多个版本的 Windows 头文件。 如果不确保使用的是最新版本的 SDK 头文件，在编译使用 Visual C++ 发布后引入的功能的代码时，将收到以下错误代码：错误 C2065：未声明的标识符。

条件声明的宏

依赖于特定版本的 Windows 的某些函数是使用条件代码声明的。 这使你可以使用编译器来检测应用程序是否使用的目标版本 (Windows) 不支持的函数。 若要编译使用这些函数的应用程序，必须定义相应的宏。 否则，将收到 C2065 错误消息。

Windows 头文件使用宏来指示哪些版本的 Windows 支持许多编程元素。 因此，必须定义这些宏才能使用每个主要操作系统版本中引入的新功能。 (单个头文件可能使用不同的宏;因此，如果发生编译问题，检查包含条件定义的头文件。) 有关详细信息，请参阅 SdkDdkVer.h。

下表描述了 Windows 头文件中使用的首选宏。 如果定义NTDDI_VERSION，还必须定义_WIN32_WINNT。

所需的最低系统 NTDDI_VERSION的值
Windows 10 1903 “19H1” NTDDI_WIN10_19H1 (0x0A000007)
Windows 10 1809 “红石 5” NTDDI_WIN10_RS5 (0x0A000006)
Windows 10 1803 “红石 4” NTDDI_WIN10_RS4 (0x0A000005)
Windows 10 1709 “红石 3” NTDDI_WIN10_RS3 (0x0A000004)
Windows 10 1703 “红石 2” NTDDI_WIN10_RS2 (0x0A000003)
Windows 10 1607 “红石 1” NTDDI_WIN10_RS1 (0x0A000002)
Windows 10 1511“阈值 2” NTDDI_WIN10_TH2 (0x0A000001)
Windows 10 1507“阈值” NTDDI_WIN10 (0x0A000000)
Windows 8.1 NTDDI_WINBLUE (0x06030000)
Windows 8 NTDDI_WIN8 (0x06020000)
Windows 7 NTDDI_WIN7 (0x06010000)
Windows Server 2008 NTDDI_WS08 (0x06000100)
Windows Vista Service Pack 1 (SP1) NTDDI_VISTASP1 (0x06000100)
Windows Vista NTDDI_VISTA (0x06000000)
Windows Server 2003 Service Pack 2 (SP2) NTDDI_WS03SP2 (0x05020200)
带有 Service Pack 1 (SP1) 的 Windows Server 2003 NTDDI_WS03SP1 (0x05020100)
Windows Server 2003 NTDDI_WS03 (0x05020000)
Windows XP Service Pack 3 (SP3) NTDDI_WINXPSP3 (0x05010300)
Windows XP Service Pack 2 (SP2) NTDDI_WINXPSP2 (0x05010200)
Windows XP Service Pack 1 (SP1) NTDDI_WINXPSP1 (0x05010100)
Windows XP NTDDI_WINXP (0x05010000)

 

下表描述了 Windows 头文件中使用的其他宏。

所需的最低系统 _WIN32_WINNT 和 WINVER 的最小值
Windows 10 _WIN32_WINNT_WIN10 (0x0A00)
Windows 8.1 _WIN32_WINNT_WINBLUE (0x0603)
Windows 8 _WIN32_WINNT_WIN8 (0x0602)
Windows 7 _WIN32_WINNT_WIN7 (0x0601)
Windows Server 2008 _WIN32_WINNT_WS08 (0x0600)
Windows Vista _WIN32_WINNT_VISTA (0x0600)
带 SP1 的 Windows Server 2003、SP2 的 Windows XP _WIN32_WINNT_WS03 (0x0502)
Windows Server 2003、Windows XP _WIN32_WINNT_WINXP (0x0501)

 

所需最低版本 最小值为 _WIN32_IE
Internet Explorer 11.0 _WIN32_IE_IE110 (0x0A00)
Internet Explorer 10.0 _WIN32_IE_IE100 (0x0A00)
Internet Explorer 9.0 _WIN32_IE_IE90 (0x0900)
Internet Explorer 8.0 _WIN32_IE_IE80 (0x0800)
Internet Explorer 7.0 _WIN32_IE_IE70 (0x0700)
Internet Explorer 6.0 SP2 _WIN32_IE_IE60SP2 (0x0603)
Internet Explorer 6.0 SP1 _WIN32_IE_IE60SP1 (0x0601)
Internet Explorer 6.0 _WIN32_IE_IE60 (0x0600)
Internet Explorer 5.5 _WIN32_IE_IE55 (0x0550)
Internet Explorer 5.01 _WIN32_IE_IE501 (0x0501)
Internet Explorer 5.0、5.0a、5.0b _WIN32_IE_IE50 (0x0500)

 

设置 WINVER 或 _WIN32_WINNT

可以使用每个源文件中的 #define 语句或指定 Visual C++ 支持的 /D 编译器选项来定义这些符号。

例如，若要在源文件中设置 WINVER，请使用以下语句：

#define WINVER 0x0502

若要在源文件中设置_WIN32_WINNT，请使用以下语句：

#define _WIN32_WINNT 0x0502

若要使用 /D 编译器选项设置_WIN32_WINNT，请使用以下命令：

cl -c /D_WIN32_WINNT=0x0502source.cpp

有关使用 /D 编译器选项的信息，请参阅 /D (预处理器定义) 。

请注意，最新版本的 Windows 中引入的某些功能可能会添加到以前版本的 Windows 的 Service Pack 中。 因此，若要以 Service Pack 为目标，可能需要为下一个主要操作系统版本定义_WIN32_WINNT值。 例如， GetDllDirectory 函数是在 Windows Server 2003 中引入的，如果_WIN32_WINNT 0x0502或更高版本，则会有条件地定义。 此函数也已添加到具有 SP1 的 Windows XP 中。 因此，如果要将_WIN32_WINNT定义为面向 Windows XP 的0x0501，则会错过使用 SP1 的 Windows XP 中定义的功能。

控制结构打包

应将项目编译为使用默认结构打包，当前为 8 个字节，因为最大的整型类型为 8 个字节。 这样做可确保头文件中的所有结构类型都以 Windows API 预期的相同对齐方式编译到应用程序中。 它还可确保具有 8 字节值的结构正确对齐，并且不会在强制数据对齐的处理器上导致对齐错误。

有关详细信息，请参阅 /Zp (结构成员对齐) 或 包。

使用较小的头文件更快地生成

可以通过排除一些不太常见的 API 声明来减小 Windows 头文件的大小，如下所示：

  • 定义WIN32_LEAN_AND_MEAN以排除加密、DDE、RPC、Shell 和 Windows 套接字等 API。

    #define WIN32_LEAN_AND_MEAN

  • 定义一个或多个 NOAPI 符号以排除 API。 例如，NOCOMM 排除串行通信 API。 有关支持无API 符号的列表，请参阅 Windows.h。

    #define NOCOMM

Windows SDK 下载站点