版本帮助程序函数

以下函数可用于确定当前操作系统版本,或者确定它是 Windows 或 Windows Server 版本。 这些函数提供简单的测试,这些测试使用 VerifyVersionInfo 函数以及建议的大于或等于比较,这些被证明是确定操作系统版本的可靠方法。

注意

这些 API 由包含在适用于 Windows 8.1 及更高版本的 Windows 软件开发工具包 (SDK) 中的 versionhelpers.h 定义。 此文件可与其他 Microsoft Visual Studio 版本配合使用,以实现 Windows 8.1 之前的 Windows 版本的相同功能。

注意

Versionhelpers.h 要求在它之前包括 windows.h

函数 说明
IsWindowsXPOrGreater 指示当前操作系统版本是与 Windows XP 版本匹配还是高于此版本。
IsWindowsXPSP1OrGreater 指示当前操作系统版本是与 Windows XP Service Pack 1 (SP1) 版本匹配还是高于此版本。
IsWindowsXPSP2OrGreater 指示当前操作系统版本是与 Windows XP Service Pack 2 (SP2) 版本匹配还是高于此版本。
IsWindowsXPSP3OrGreater 指示当前操作系统版本是与 Windows XP Service Pack 3 (SP3) 版本匹配还是高于此版本。
IsWindowsVistaOrGreater 指示当前操作系统版本是与 Windows Vista 版本匹配还是高于此版本。
IsWindowsVistaSP1OrGreater 指示当前操作系统版本是与 Windows Vista Service Pack 1 (SP1) 版本匹配还是高于此版本。
IsWindowsVistaSP2OrGreater 指示当前操作系统版本是与 Windows Vista Service Pack 2 (SP2) 版本匹配还是高于此版本。
IsWindows7OrGreater 指示当前操作系统版本是与 Windows 7 版本匹配还是高于此版本。
IsWindows7SP1OrGreater 指示当前操作系统版本是与 Windows 7 Service Pack 1 (SP1) 版本匹配还是高于此版本。
IsWindows8OrGreater 指示当前操作系统版本是与 Windows 8 版本匹配还是高于此版本。
IsWindows8Point1OrGreater 指示当前操作系统版本是与 Windows 8.1 版本匹配还是高于此版本。

对于 Windows 10,IsWindows8Point1OrGreater 会返回 false,除非应用程序包含的清单包括一个兼容性部分,并且该兼容性部分包含用于指定 Windows 8.1 和/或 Windows 10 的 GUID。
IsWindows10OrGreater 指示当前操作系统版本是与 Windows 10 版本匹配还是高于此版本。

对于 Windows 10,IsWindows10OrGreater 会返回 false,除非应用程序包含的清单包括一个兼容性部分,并且该兼容性部分包含用于指定 Windows 10 的 GUID。
IsWindowsServer 指示当前操作系统是否为 Windows Server 版本。 需要区分 Windows 的服务器版本和客户端版本的应用程序应调用此函数。
IsWindowsVersionOrGreater 仅当其他提供的版本帮助程序函数不适合您的场景时,您才应该使用此函数。

指示当前操作系统版本是与提供的版本信息匹配还是高于此版本。 此函数可用于确认不与客户端版本共享版本号的 Windows Server 版本。

示例

利用 VersionHelpers.h 头文件中定义的内联函数,你可以在测试 Windows 版本时返回布尔值来验证操作系统版本。

例如,如果应用程序需要 Windows 10 或更高版本,请使用以下测试。

#include <windows.h>
#include <VersionHelpers.h>
 
if (!IsWindows10OrGreater())
{
   MessageBox(NULL, "You need at least Windows 10", "Version Not Supported", MB_OK);
}