WINVER および _WIN32_WINNT の更新

Windows SDK を使用する場合、ご自身のコードを実行できる Windows のバージョンを指定できます。 プリプロセッサ マクロ WINVER_WIN32_WINNT によって、ご自身のコードがサポートするオペレーティング システムの最小バージョンが指定されます。 Visual Studio と Microsoft C++ コンパイラのサポートは、Windows 7 SP1 以降を対象にしています。 以前のツールセットには、Windows XP SP2、Windows server 2003 SP1、Vista、Windows server 2008 のサポートが含まれています。 Windows 95、Windows 98、Windows ME、Windows NT、Windows 2000 はサポートされていません。

古いプロジェクトをアップグレードするときに、お使いの WINVER マクロまたは _WIN32_WINNT マクロの更新が必要になる場合があります。 サポートされていないバージョンの Windows の値が割り当てられていると、これらのマクロに関連するコンパイル エラーが発生する可能性があります。

解説

マクロを変更するには、ヘッダー ファイル (たとえば、Windows を対象とする一部のプロジェクト テンプレートによって追加される targetver.h) 内で、以下の行を追加します。

#define WINVER 0x0A00
#define _WIN32_WINNT 0x0A00

この例のマクロは、Windows 10 オペレーティング システムのすべてのバージョンを対象とするように設定されています。 使用できる値は、Windows メジャー バージョンごとにマクロを定義する Windows ヘッダー ファイル sdkddkver.h にリストされています。 以前の Windows プラットフォームをサポートするようにアプリケーションをビルドするには、WinSDKVer.h を含めます。 その後、sdkddkver.h を含める前に、WINVER マクロと _WIN32_WINNT マクロを、サポートされている最も古いプラットフォームに設定します。 Windows の各メジャー バージョンの値をエンコードする、sdkddkver.h の Windows 10 SDK バージョンの行を次に示します。

//
// _WIN32_WINNT version constants
//
#define _WIN32_WINNT_NT4                    0x0400 // Windows NT 4.0
#define _WIN32_WINNT_WIN2K                  0x0500 // Windows 2000
#define _WIN32_WINNT_WINXP                  0x0501 // Windows XP
#define _WIN32_WINNT_WS03                   0x0502 // Windows Server 2003
#define _WIN32_WINNT_WIN6                   0x0600 // Windows Vista
#define _WIN32_WINNT_VISTA                  0x0600 // Windows Vista
#define _WIN32_WINNT_WS08                   0x0600 // Windows Server 2008
#define _WIN32_WINNT_LONGHORN               0x0600 // Windows Vista
#define _WIN32_WINNT_WIN7                   0x0601 // Windows 7
#define _WIN32_WINNT_WIN8                   0x0602 // Windows 8
#define _WIN32_WINNT_WINBLUE                0x0603 // Windows 8.1
#define _WIN32_WINNT_WINTHRESHOLD           0x0A00 // Windows 10
#define _WIN32_WINNT_WIN10                  0x0A00 // Windows 10
// . . .

より詳細なバージョン管理の方法の場合は、sdkddkver.h 内で NTDDI バージョン定数を使用できます。 Windows 10 SDK バージョン 10.0.18362.0 内で、sdkddkver.h によって定義されているマクロの一部を次に示します。

//
// NTDDI version constants
//
#define NTDDI_WIN7                          0x06010000
#define NTDDI_WIN8                          0x06020000
#define NTDDI_WINBLUE                       0x06030000
#define NTDDI_WINTHRESHOLD                  0x0A000000  /* ABRACADABRA_THRESHOLD */
#define NTDDI_WIN10                         0x0A000000  /* ABRACADABRA_THRESHOLD */
#define NTDDI_WIN10_TH2                     0x0A000001  /* ABRACADABRA_WIN10_TH2 */
#define NTDDI_WIN10_RS1                     0x0A000002  /* ABRACADABRA_WIN10_RS1 */
#define NTDDI_WIN10_RS2                     0x0A000003  /* ABRACADABRA_WIN10_RS2 */
#define NTDDI_WIN10_RS3                     0x0A000004  /* ABRACADABRA_WIN10_RS3 */
#define NTDDI_WIN10_RS4                     0x0A000005  /* ABRACADABRA_WIN10_RS4 */
#define NTDDI_WIN10_RS5                     0x0A000006  /* ABRACADABRA_WIN10_RS5 */
#define NTDDI_WIN10_19H1                    0x0A000007  /* ABRACADABRA_WIN10_19H1*/

#define WDK_NTDDI_VERSION                   NTDDI_WIN10_19H1 /* ABRACADABRA_WIN10_19H1 */

//
// masks for version macros
//
#define OSVERSION_MASK      0xFFFF0000
#define SPVERSION_MASK      0x0000FF00
#define SUBVERSION_MASK     0x000000FF

//
// macros to extract various version fields from the NTDDI version
//
#define OSVER(Version)  ((Version) & OSVERSION_MASK)
#define SPVER(Version)  (((Version) & SPVERSION_MASK) >> 8)
#define SUBVER(Version) (((Version) & SUBVERSION_MASK) )

ご自身のコード内で OSVER マクロ、SPVER マクロ、SUBVER マクロを使用すると、さまざまなレベルの API サポートに対する条件付きのコンパイルを制御することができます。

表示されている sdkddkver.h に、これらの Windows バージョンの一部がないこともあります。 これは、さらに古いバージョンの Windows SDK を使用している可能性があることを意味します (さらに表示される場合は、より新しいバージョンの SDK を見ている可能性があります)。既定では、Visual Studioの新しいWindows プロジェクトでは、Visual Studioに付属する最新のWindows SDK が使用されます。 個別にインストールしたさらに新しい SDK を使用するには、ご自身のプロジェクトのプロパティ内で Windows SDK を明示的に設定する必要があります。

Note

アプリケーションに内部 MFC ヘッダーを含めた場合には、値が動作する保証はありません。

/D コンパイラ オプションを使用して、このマクロを定義することもできます。 詳細については、「 /D (Preprocessor Definitions)」を参照してください。

これらのマクロの意味について詳しくは、「 Windows ヘッダーの使用」をご覧ください。

関連項目

Visual C++ の変更履歴