A common source of confusion for Windows development is the Windows SDK naming scheme. For example: Can someone use the “Windows SDK for Windows Server 2008 and .NET Framework 3.5” to target Windows XP?
The recommendation is for developers to use the latest version of the Windows SDK they can for access to the latest technologies and APIs, given the restrictions of your projects development platform, target platforms, and toolset. Figuring out this matrix of choices is a bit challenging, so this blog post spells out some key differences.
For a more complete version history, you might want to check out Wikipedia.
Q: What SDK am I using currently?
Most developers get a copy of the Windows SDK or Platform SDK with their Visual Studio installation.
|Visual Studio 2019||Windows 10 SDK (17763 or 18363) Windows 8.1 SDK Spring 2015 [optional] Windows 7.1A SDK for ``v14?_xp`` Platform Toolset|
|Visual Studio 2017||Windows 10 SDK (14393, 15063, 16299, or 17763) Windows 8.1 SDK Spring 2015 [optional] Windows 7.1A SDK for ``v14?_xp`` Platform Toolset|
|Visual Studio 2015||Windows 8.1 SDK Spring 2015 Windows 10 SDK (10240, 10586, or 14393) [optional] Windows 7.1A SDK for ``v140_xp`` Platform Toolset|
|Visual Studio 2013||Windows 8.1 SDK (VS 2013 Update 3 and Update 5 contain newer versions) Windows 7.1A SDK for ``v120_xp`` Platform Toolset VS 2013 Express for Windows only includes a subset of the full Windows 8.1 SDK|
|Visual Studio 2012||Windows 8.0 SDK Windows 7.1A SDK for ``v110_xp`` Platform Toolset (added in Update 1) VS 2012 Express for Windows only includes a subset of the full Windows 8.0 SDK|
|Visual Studio 2010||Windows SDK 7.0A Similar to Windows SDK for Windows 7 and .NET Framework 3.5 SP1 (August 2009)|
|Visual Studio 2008||Windows SDK 6.0A Similar to Windows SDK for Windows Vista Update and .NET Framework 3.0 (February 2007)|
|Visual Studio 2005||Similar to Windows Server 2003 SP1 Platform SDK (April 2005) VS 2005 Express did not include the Platform SDK|
Which version of the Windows 10 SDK you get by default with VS 2017 depends on which Visual Studio update you are installing. With VS 2017 (15.9), you’ll get Windows 10 SDK (17763) but you can choose the other versions as optional components.
Q: What platform does a given Windows SDK target?
Given the naming scheme for the Window SDKs, this is probably the most confusing aspect of choosing a Windows SDK. The easiest way to describe it is to list the last releases which allowed you to target a given OS.
- Windows SDK 7.1 (aka Windows SDK for Windows 7 and .NET Framework 4.0) was the last release to support targeting Windows XP and Windows Server 2003.
- Windows Server 2003 SP1 Platform SDK (April 2005) was the last release to support targeting Windows 2000.
Q: What platform does a given Window SDK support for development?
Another aspect is that the Windows SDK often supports a smaller set of platforms for development (i.e. it can be installed on) compared to those it can target (i.e. deploy applications to).
- Windows 10 SDK requires Windows 7 SP1, Windows 8, Windows 8.1, or Windows 10
- Windows 8.1 SDK requires Windows 7 SP1, Windows 8, or Windows 8.1
- Windows 8.0 SDK requires Windows 7 or Windows 8.x
Q: What compiler toolset does a given Windows SDK support?
Not all Windows SDKs can be used with all versions of Visual Studio. Changes in language features,
/analyze SAL annotation, and other aspects of the compiler toolset are assumed as the baseline for a given Visual Studio release–usually that version that comes with a given Visual Studio release is the ‘oldest’ one it supports.
- Windows 10 SDK (14393 or later) supports Visual Studio 2017. For
/permissive-you should have the latest version of the compiler and SDK available.
- Windows 10 SDK (10240, 10586, or 14393) supports Visual Studio 2015
- Windows 8.1 SDK supports Visual Studio 2010 or later. To use with VS 2010 or VS 2012 requires manual integration per this blog post.
- Windows 8.0 SDK supports Visual Studio 2010 or later. To use with VS 2010 requires manual integration per this blog post.
- Windows 7.1 SDK supports Visual Studio 2005 or later.
- Platform SDK (February 2003) was the last release to support Visual Studio 6.
Q: How do I use a newer SDK to target an older version of Windows?
The standard way of doing this is to set a Preprocessor Define
_WIN32_WINNT to the appropriate value for the ‘oldest’ version of Windows you are targeting (see Using the Windows Headers). This causes the headers to work in such a way that newer APIs are not available at build time. This can get a bit complicated for “Platform Updates” that put portions of newer OS features onto older version of Windows, but otherwise
_WIN32_WINNT is usually sufficient to get the expected behavior. Otherwise, you can set a ‘higher’ value to give you access to newer APIs, but the programmer must take care to handle detection or fallback as needed for partially supported or unsupported APIs on down-level versions of Windows (i.e. WIC2, Direct3D 11)
Note that unlike previous Windows SDKs, the Windows 8.x SDKs use a default value of
_WIN32_WINNT that is the ‘newest’ rather than the ‘oldest’ version of the OS.