バージョン ヘルパー関数

次の機能を使用して、現在のオペレーティング システムのバージョンを確認したり、Windowsまたはサーバー リリースWindows識別したりできます。 これらの関数は 、VerifyVersionInfo 関数を使用する簡単なテストを提供し、オペレーティング システムのバージョンを決定するための堅牢な手段として証明されている比較以上に推奨されます。

Note

これらの API は、Windows 8.1 ソフトウェア開発キット (SDK) に含まれる versionhelpers.h によって定義されます。 このファイルは、他のMicrosoft Visual Studio リリースと共に使用して、Windows 8.1より前のバージョンWindows同じ機能を実装できます。

機能 説明
IsWindowsXPOrGreater 現在の OS バージョンが、Windows XP バージョンと一致するか、それよりも大きいかどうかを示します。
IsWindowsXPSP1OrGreater 現在の OS バージョンが Service Pack 1 (SP1) バージョンのWindows XP と一致するか、それより大きいかどうかを示します。
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の場合、アプリケーションに、Windows 8.1やWindows 10を指定する GUID を含む互換性セクションを含むマニフェストが含まれている場合を除き、IsWindows8Point1OrGreater は false を返します。
IsWindows10OrGreater 現在の OS バージョンが、Windows 10 バージョンと一致するか、それよりも大きいかどうかを示します。
Windows 10の場合、アプリケーションに、Windows 10を指定する GUID を含む互換性セクションを含むマニフェストが含まれている場合を除き、IsWindows10OrGreater は false を返します。
IsWindowsServer 現在の OS が Windows Server リリースであるかどうかを示します。 サーバーバージョンとクライアントバージョンのWindowsを区別する必要があるアプリケーションでは、この関数を呼び出す必要があります。
IsWindowsVersionOrGreater
この関数は、他のバージョン ヘルパー関数がシナリオに合わない場合にのみ使用してください。

現在の OS バージョンが、指定されたバージョン情報と一致するか、それより大きいかどうかを示します。 この関数は、バージョン番号をクライアント リリースと共有していない Windows Server のバージョンを確認する場合に役立ちます。

VersionHelpers.h ヘッダー ファイルで定義されているインライン関数を使用すると、バージョンのWindowsのテスト時にブール値を返すことで、オペレーティング システムのバージョンを確認できます。

たとえば、アプリケーションでWindows 8以降が必要な場合は、次のテストを使用します。

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