VerifyVersionInfoW 関数 (winbase.h)
オペレーティング システムのバージョン要件のセットを、現在実行中のシステムのバージョンに対応する値と比較します。この関数は、マニフェストベースの動作の対象となります。 詳細については、「解説」を参照してください。
メモ：この関数は、Windows 10では非推奨になりました。 詳細については、「 Windows 用アプリケーションのターゲット設定 」を参照してください。
構文
BOOL VerifyVersionInfoW(
[in] LPOSVERSIONINFOEXW lpVersionInformation,
[in] DWORD dwTypeMask,
[in] DWORDLONG dwlConditionMask
);
パラメーター
[in] lpVersionInformation
比較するオペレーティング システムのバージョン要件を含む OSVERSIONINFOEX 構造体へのポインター。 dwTypeMask パラメーターは、比較する情報を含むこの構造体のメンバーを示します。
この構造体の dwOSVersionInfoSize メンバーを に設定する sizeof(OSVERSIONINFOEX)必要があります。 dwTypeMask で示されるメンバーの有効なデータも指定する必要があります。 関数は、対応する dwTypeMask ビットが設定されていない構造体メンバーを無視します。
[in] dwTypeMask
テストする OSVERSIONINFOEX 構造体のメンバーを示すマスク。 このパラメーターには、次の 1 つ以上の値を指定できます。
[in] dwlConditionMask
比較対象の各 lpVersionInfo メンバーに使用する比較の種類。 この値をビルドするには、比較対象の OSVERSIONINFOEX メンバーごとに VerSetConditionMask 関数または VER_SET_CONDITION マクロを 1 回呼び出します。
戻り値
現在実行中のオペレーティング システムが指定された要件を満たしている場合、戻り値は 0 以外の値になります。
現在のシステムが要件を満たしていない場合、戻り値は 0 で 、GetLastError はERROR_OLD_WIN_VERSIONを返します。
関数が失敗した場合、戻り値は 0 で、 GetLastError は ERROR_OLD_WIN_VERSION以外のエラー コードを返します。
注釈
VerifyVersionInfo 関数は、現在実行中のオペレーティング システムに関するバージョン情報を取得し、lpVersionInfo 構造体の有効なメンバーと比較します。 これにより、オペレーティング システムのバージョン条件の必要なセットの存在を簡単に判断できます。 GetVersionEx 関数を呼び出して独自の比較を実行するのではなく、VerifyVersionInfo を使用することをお勧めします。
通常、 VerifyVersionInfo は、指定されたすべてのテストが成功した場合にのみ 0 以外の値を返します。 ただし、オペレーティング システムのバージョンはこれらの値の組み合わせであるため、メジャー、マイナー、および Service Pack のバージョンは階層的な方法でテストされます。 メジャー バージョンに条件が存在する場合は、マイナー バージョンと Service Pack バージョンに指定された条件よりも優先されます。 (5 より大きいメジャー バージョンと 1 以下のマイナー バージョンをテストすることはできません。このようなテストを指定すると、メジャー バージョンに対してより大きい操作が実行されるため、関数は要求を変更して 1 より大きいマイナー バージョンをテストします)。
関数は、メジャー バージョン、マイナー バージョン、および Service Pack バージョンの順にこれらの値をテストします。 関数は、値が等しい間はテストを続け、値の 1 つが指定された条件を満たしていない場合は停止します。 たとえば、バージョン 5.1 Service Pack 1 以上のシステムをテストする場合、現在のバージョンが 6.0 の場合、テストは成功します。 (メジャー バージョンが指定したバージョンより大きいので、テストは停止します)。同様に、バージョン 5.1 Service Pack 1 以上のシステムをテストする場合、現在のバージョンが 5.2 の場合、テストは成功します。 (マイナー バージョンが指定したバージョンより大きいので、テストは停止します)。ただし、バージョン 5.1 Service Pack 1 以上のシステムをテストする場合、現在のバージョンが 5.0 Service Pack 2 の場合、テストは失敗します。 (マイナー バージョンは指定したバージョンより大きくないため、テストは停止します)。
システム バージョンの範囲を確認するには、 VerifyVersionInfo を 2 回呼び出す必要があります。 たとえば、システム バージョンが 5.0 より大きく、5.1 以下であることを確認するには、最初に VerifyVersionInfo を呼び出してメジャー バージョンが 5 でマイナー バージョンが 0 より大きいかどうかをテストし、 再び VerifyVersionInfo を呼び出してメジャー バージョンが 5 でマイナー バージョンが 1 以下であることをテストします。
現在のオペレーティング システムを特定することは、通常、特定のオペレーティング システム機能が存在するかどうかを判断する最善の方法ではありません。 これは、オペレーティング システムに再頒布可能 DLL に新機能が追加された可能性があるためです。 GetVersionEx を使用してオペレーティング システムのプラットフォームまたはバージョン番号を決定するのではなく、機能自体が存在するかどうかをテストします。 詳細については、「 オペレーティング システムのバージョン」を参照してください。
現在のオペレーティング システムが Media Center またはタブレット PC バージョンの Windows かどうかを確認するには、 GetSystemMetrics を呼び出します。
Windows 10: 現在のオペレーティング システムであっても、lpVersionInfo パラメーターがWindows 8.1またはWindows 10を指定するように lpVersionInfo パラメーターが設定されている場合、Windows 8.1またはWindows 10の互換性マニフェストを持たないアプリケーションによって呼び出された場合、VerifyVersionInfo は false を返しますversion がWindows 8.1またはWindows 10。 具体的には、 VerifyVersionInfo には次の動作があります。
- アプリケーションにマニフェストがない場合、VerifyVersionInfo は、操作システムのバージョンがWindows 8 (6.2) であるかのように動作します。
- アプリケーションに、Windows 8.1に対応する GUID を含むマニフェストがある場合、VerifyVersionInfo は、操作システムのバージョンがWindows 8.1 (6.3) であるかのように動作します。
- アプリケーションに、Windows 10に対応する GUID を含むマニフェストがある場合、VerifyVersionInfo は、操作システムのバージョンがWindows 10 (10.0) であるかのように動作します。
Windows 8.1またはWindows 10用にアプリケーションをマニフェストするには、「Windows 用アプリケーションのターゲット設定」を参照してください。
例
例については、「 システム バージョンの確認」を参照してください。
注意
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして VerifyVersionInfo を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winbase.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示