Windows ヘッダーの使用

Windows API のヘッダー ファイルを使用すると、32 ビットおよび 64 ビットのアプリケーションを作成できます。 これには、Unicode バージョンと ANSI バージョンの両方の API に対する宣言が含まれます。 詳細については、「Windows API の Unicode」を参照してください。 1 つのソース コード ベースから 32 ビットバージョンと 64 ビット バージョンの両方のアプリケーションをビルドできるデータ型を使用します。 詳細については、「64 ビット Windows の準備」を参照してください。 その他の機能には、ヘッダー注釈および STRICT 型チェックなどがあります。

Visual C++ と Windows ヘッダー ファイル

Microsoft Visual C++ には、Visual C++ のリリース時に最新であった Windows ヘッダー ファイルのコピーが含まれています。 そのため、更新されたヘッダー ファイルを SDK からインストールすると、コンピューターに複数のバージョンの Windows ヘッダー ファイルがインストールされる可能性があります。 使用している SDK ヘッダー ファイルが最新バージョンであることを確認しておかないと、Visual C++ のリリース後に導入された機能を使用するコードのコンパイル時に、エラー C2065 (宣言されていない識別子) が表示されます。

条件付き宣言のマクロ

特定のバージョンの Windows に依存する特定の関数は、条件付きコードを使用して宣言されます。 これにより、コンパイラを使用して、アプリケーションがそのターゲット バージョンの Windows でサポートされていない関数を使用しているかどうかを検出できます。 これらの関数を使用するアプリケーションをコンパイルするには、適切なマクロを定義する必要があります。 そうしないと、C2065 エラー メッセージが表示されます。

Windows ヘッダー ファイルでは、マクロを使用して、多くのプログラミング要素をサポートする Windows のバージョンを示します。 そのため、オペレーティング システムの各メジャー リリースで導入された新機能を使用するには、これらのマクロを定義する必要があります。 (個々のヘッダー ファイルでは異なるマクロが使用される場合があるため、コンパイルの問題が発生した場合は、条件付き定義の定義を含むヘッダー ファイルを確認してください)。詳細については、「SdkDdkVer.h」を参照してください。

次の表では、Windows ヘッダー ファイルで使用される優先マクロについて説明します。 NTDDI_VERSION を定義する場合は、_WIN32_WINNT も定義する必要があります。

最小システム要件 NTDDI_VERSION の値
Windows 10 1903 "19H1" NTDDI_WIN10_19H1 (0x0A000007)
Windows 10 1809 "Redstone 5" NTDDI_WIN10_RS5 (0x0A000006)
Windows 10 1803 "Redstone 4" NTDDI_WIN10_RS4 (0x0A000005)
Windows 10 1709 "Redstone 3" NTDDI_WIN10_RS3 (0x0A000004)
Windows 10 1703 "Redstone 2" NTDDI_WIN10_RS2 (0x0A000003)
Windows 10 1607 "Redstone 1" NTDDI_WIN10_RS1 (0x0A000002)
Windows 10 1511 "Threshold 2" NTDDI_WIN10_TH2 (0x0A000001)
Windows 10 1507 "Threshold" NTDDI_WIN10 (0x0A000000)
Windows 8.1 NTDDI_WINBLUE (0x06030000)
Windows 8 NTDDI_WIN8 (0x06020000)
Windows 7 NTDDI_WIN7 (0x06010000)
Windows サーバー 2008 NTDDI_WS08 (0x06000100)
Windows Vista Service Pack 1 (SP1) NTDDI_VISTASP1 (0x06000100)
Windows Vista NTDDI_VISTA (0x06000000)
Windows Server 2003 Service Pack 2 (SP2) NTDDI_WS03SP2 (0x05020200)
Windows Server 2003 Service Pack 1 (SP1) NTDDI_WS03SP1 (0x05020100)
Windows Server 2003 NTDDI_WS03 (0x05020000)
Windows XP with Service Pack 3 (SP3) NTDDI_WINXPSP3 (0x05010300)
Windows XP with Service Pack 2 (SP2) NTDDI_WINXPSP2 (0x05010200)
Windows XP with Service Pack 1 (SP1) NTDDI_WINXPSP1 (0x05010100)
Windows XP NTDDI_WINXP (0x05010000)

 

次の表では、Windows ヘッダー ファイルで使用されるその他のマクロについて説明します。

最小システム要件 _WIN32_WINNT と WINVER の最小値
Windows 10 _WIN32_WINNT_WIN10 (0x0A00)
Windows 8.1 _WIN32_WINNT_WINBLUE (0x0603)
Windows 8 _WIN32_WINNT_WIN8 (0x0602)
Windows 7 _WIN32_WINNT_WIN7 (0x0601)
Windows サーバー 2008 _WIN32_WINNT_WS08 (0x0600)
Windows Vista _WIN32_WINNT_VISTA (0x0600)
Windows Server 2003 SP1、Windows XP SP2 _WIN32_WINNT_WS03 (0x0502)
Windows Server 2003、Windows XP _WIN32_WINNT_WINXP (0x0501)

 

必要最小バージョン _WIN32_IE の最小値
Internet Explorer 11.0 _WIN32_IE_IE110 (0x0A00)
Internet Explorer 10.0 _WIN32_IE_IE100 (0x0A00)
Internet Explorer 9.0 _WIN32_IE_IE90 (0x0900)
Internet Explorer 8.0 _WIN32_IE_IE80 (0x0800)
Internet Explorer 7.0 _WIN32_IE_IE70 (0x0700)
Internet Explorer 6.0 SP2 _WIN32_IE_IE60SP2 (0x0603)
Internet Explorer 6.0 SP1 _WIN32_IE_IE60SP1 (0x0601)
Internet Explorer 6.0 _WIN32_IE_IE60 (0x0600)
Internet Explorer 5.5 _WIN32_IE_IE55 (0x0550)
Internet Explorer 5.01 _WIN32_IE_IE501 (0x0501)
Internet Explorer 5.0、5.0a、5.0b _WIN32_IE_IE50 (0x0500)

 

WINVER または_WIN32_WINNTの設定

これらのシンボルを定義するには、各ソース ファイルで #define ステートメントを使用するか、Visual C++ でサポートされている /D コンパイラ オプションを指定します。

たとえば、ソース ファイルに WINVER を設定するには、次のステートメントを使用します。

#define WINVER 0x0502

ソース ファイルに _WIN32_WINNT を設定するには、次のステートメントを使用します。

#define _WIN32_WINNT 0x0502

/D コンパイラ オプションを使用して _WIN32_WINNT を設定するには、次のコマンドを使用します。

cl -c /D_WIN32_WINNT=0x0502 source.cpp

/D コンパイラ オプションの使用について詳しくは、「/D (プリプロセッサ定義)」を参照してください。

最新バージョンの Windows で導入された一部の機能は、以前のバージョンの Windows のサービス パックに追加される可能性があることに注意してください。 そのため、サービス パックをターゲットにするには、オペレーティング システムのメジャー リリースに対する次の値を使用して _WIN32_WINNT を定義することが必要な場合があります。 たとえば、GetDllDirectory 関数は Windows Server 2003 で導入されたもので、_WIN32_WINNT が 0x0502 以上の場合に条件付きで定義されます。 この関数は、Windows XP SP1 にも追加されました。 そのため、Windows XP をターゲットにする 0x0501 として _WIN32_WINNT を定義すると、Windows XP SP1 で定義されている機能が欠落してしまいます。

構造体のパックの制御

プロジェクトは、既定の構造体のパックを使用するようにコンパイルする必要があり、最大整数型が 8 バイトであるため現在は 8 バイトになります。 そうすることで、ヘッダー ファイル内のすべての構造体型が、Windows API で想定されているものと同じ配置でアプリケーションにコンパイルされます。 また、それによって 8 バイトの値を持つ構造体が適切に配置されるようになり、データの配置を強制するプロセッサで配置エラーが発生しなくなります。

詳細については、「/Zp (構造体メンバーの配置)」または「pack」を参照してください。

より小さいヘッダー ファイルを使用したビルドの高速化

次のように、あまり一般的でない API 宣言の一部を除外することで、Windows ヘッダー ファイルのサイズを小さくできます。

  • WIN32_LEAN_AND_MEAN を定義して、Cryptography、DDE、RPC、Shell などの API、および Windows ソケットを除外します。

    #define WIN32_LEAN_AND_MEAN

  • 1 つ以上の NOapi シンボルを定義して、該当する API を除外します。 たとえば、NOCOMM はシリアル通信 API を除外します。 サポート NOapi シンボルの一覧については、Windows.h を参照してください。

    #define NOCOMM

Windows SDK ダウンロード サイト