IsWindowsXPSP3OrGreater 関数 (versionhelpers.h)

[アーティクル]
08/27/2023

現在の OS バージョンが Service Pack 3 (SP3) バージョンの Windows XP と一致するか、またはより大きいかどうかを示します。

構文

VERSIONHELPERAPI IsWindowsXPSP3OrGreater();

戻り値

現在の OS バージョンが SP3 バージョンの Windows XP と一致する場合、またはより大きい場合は True。それ以外の場合は false。

注釈

この関数は、クライアントリリースとサーバーリリースを区別しません。現在の OS のバージョン番号が呼び出しで指定されたクライアントのバージョン以上の場合は true を返します。たとえば、 IsWindowsXPSP3OrGreater を呼び出すと、Windows Server 2008 で true が返されます。サーバーとクライアントのバージョンの Windows を区別する必要があるアプリケーションでは、IsWindowsServer を呼び出す必要があります。

Windows Server のバージョン番号が Windows クライアントリリースと共有されていない場合は、 IsWindowsVersionOrGreater を使用して確認できます。

例

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

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

#include <VersionHelpers.h>
…
    if (!IsWindowsXPSP3OrGreater())
    {
       MessageBox(NULL, "You need at least Windows XP with SP3", "Version Not Supported", MB_OK);
    }

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	versionhelpers.h
Library	Kernel32.lib;Ntdll.lib
[DLL]	Kernel32.dll;Ntdll.dll