バージョン ヘルパー関数
次の関数は、現在のオペレーティング システムのバージョンの確認やそれが 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);
}