版本協助程式函式

  • 發行項

下列函式可用來判斷目前的操作系統版本，或識別其為 Windows 或 Windows Server 版本。 這些函式提供使用 VerifyVersionInfo 函式的簡單測試，以及建議大於或等於已證明為強固方法的比較，以判斷作業系統版本。

注意

這些 API 是由 versionhelpers.h 所定義，其包含在適用於 Windows 8.1 和更新版本的 Windows 軟體開發工具包 （SDK） 中。 此檔案可以與其他 Microsoft Visual Studio 版本搭配使用，以針對 Windows 8.1 之前的 Windows 版本實作相同的功能。

注意

Versionhelpers.h 需要 先包含 windows.h 才能包含。

函式 描述
IsWindowsXPOrGreater 指出目前的OS版本是否符合或大於Windows XP版本。
IsWindowsXPSP1OrGreater 指出目前的OS版本是否符合或大於Windows XP Service Pack 1 （SP1） 版本。
IsWindowsXPSP2OrGreater 指出目前的OS版本是否符合或大於Service Pack 2 （SP2） 版本的 Windows XP。
IsWindowsXPSP3OrGreater 指出目前的OS版本是否符合或大於Service Pack 3 （SP3） 版本的 Windows XP。
IsWindowsVistaOrGreater 指出目前的OS版本是否符合或大於Windows Vista版本。
IsWindowsVistaSP1OrGreater 指出目前的OS版本是否符合或大於 Service Pack 1 （SP1） 版本的 Windows Vista。
IsWindowsVistaSP2OrGreater 指出目前的OS版本是否符合或大於 Service Pack 2 （SP2） 版本的 Windows Vista。
IsWindows7OrGreater 指出目前的OS版本是否符合或大於Windows 7版本。
IsWindows7SP1OrGreater 指出目前的OS版本是否符合或大於 Service Pack 1 （SP1） 版本的 Windows 7。
IsWindows8OrGreater 指出目前的OS版本是否符合或大於Windows 8版本。
IsWindows8Point1OrGreater 指出目前的OS版本是否符合或大於Windows 8.1版本。

若為 Windows 10，IsWindows8Point1OrGreater 會傳回 false，除非應用程式包含包含相容性區段的指令清單，其中包含指定 Windows 8.1 和/或 Windows 10 的 GUID。
IsWindows10OrGreater 指出目前的OS版本是否符合或大於Windows 10版本。

若為 Windows 10，IsWindows10OrGreater 會傳回 false，除非應用程式包含指定 Windows 10 之 GUID 的相容性區段的指令清單。
IsWindowsServer 指出目前的OS是否為 Windows Server 版本。 需要區別伺服器和用戶端版本的 Windows 應用程式應該呼叫此函式。
IsWindowsVersionOrGreater 只有當其他提供的版本協助程式函式不符合您的案例時，才應該使用此函式。

指出目前的OS版本是否符合或大於所提供的版本資訊。 此函式有助於確認未與用戶端版本共用版本號碼的 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);
}