バージョン ヘルパー関数
次の関数を使用して、現在のオペレーティング システムのバージョンを確認したり、それが Windows または Windows Server のリリースであるかどうかを識別したりできます。 これらの関数は、VerifyVersionInfo 関数を使用する簡単なテストと、オペレーティング システムのバージョンを決定するための堅牢な手段として証明されている比較以上の推奨テストを提供します。
手記
これらの API は、windows 8.1 以降の Windows ソフトウェア開発キット (SDK) に含まれる versionhelpers.hによって定義されます。 このファイルは、他の Microsoft Visual Studio リリースと共に使用して、Windows 8.1 より前のバージョンの Windows に同じ機能を実装できます。
手記
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 バージョンが、Windows Vista Service Pack 1 (SP1) バージョンと一致するか、それより大きいかどうかを示します。 |
IsWindowsVistaSP2OrGreaterの | 現在の OS バージョンが、Windows Vista Service Pack 2 (SP2) バージョンと一致するか、それより大きいかどうかを示します。 |
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);
}
関連トピック
- OSVERSIONINFOEX の