バージョン ヘルパー関数

  • [アーティクル]

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

Note

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

Note

Versionhelpers.h の前に windows.h を含めることが必要です。

関数 説明
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 10 以降が必要な場合は、次のテストを使用します。

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