NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #2455 most downloaded on NuGet
C++/WinRT is a standard C++ language projection for the Windows Runtime implemented solely in header files. It allows you to both author and consume Windows Runtime APIs using any standards-compliant C++ compiler. C++/WinRT is designed to provide C++ developers with first-class access to the modern Windows API.
Last release 3 months ago
19 Aug 2026
Release timing varies
gaps range from 2 weeks to 1.1 years
Most releases are documented
notes for 51 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
142 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Fix race condition in cancellation setup/teardown by @oldnewthing in https://github.com/microsoft/cppwinrt/pull/1609
Full Changelog: https://github.com/microsoft/cppwinrt/compare/3.0.260715.1...3.0.260818.1
base_identity.h: added missing constexpr by @matbech in https://github.com/microsoft/cppwinrt/pull/1589
Full Changelog: https://github.com/microsoft/cppwinrt/compare/3.0.260520.1...3.0.260715.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
…support for C++20 modules, and support for deprecated pre-standard coroutines has been removed.
In addition to the usual bugfixes and enhancements, this first 3.0 release contains two major updates: support for C++20 modules, and support for deprecated pre-standard coroutines has been removed.
C++/WinRT has removed support for the pre-standard coroutines via the /await compiler option and the <experimental/coroutine> header. This aligns with the new behavior in the MSVC Build Tools 14.50 (shipping in Visual Studio 2026) that officially deprecated /await, and will soon deprecate the experimental headers. Standard coroutines are available by default starting in C++20, or if you are still on C++17, use /await:strict.
If your existing projects are using the Nupkg support out of the box and have not manually added /await, you probably won't have to change anything, as we've updated the default behavior in Microsoft.Windows.CppWinRT.targets to use /await:strict when building with C++17. If for some reason, you need to override this default behavior in the targets file, you can set CppWinRTEnableCpp17Coroutines to false to prevent it from auto-setting /await:strict.
Full module support has finally arrived to C++/WinRT! Replace
#include <winrt/Windows.Foundation.h>
with
import winrt.Windows.Foundation;
and rejoice!
This brings potential improvements in build speed, disk space, and memory usage, particularly for large projects using Xaml projections, and starts to isolate more of the internal C++/WinRT implementation details from the consumer side. Test-driving this work on a quick and dirty prototype fork of Windows Terminal yielded a 10-15% build speed improvement (22 minutes before, 19 minutes after), and a reduction in disk space from 30GB down to 18GB.
If you've ever used C++/WinRT with Windows.UI.Xaml.*, you've probably moved those headers into your precompiled header (PCH), but then saw your PCH consume well upwards of 1-2GB of disk space per vcxproj, per flavor. In the Terminal prototype, taking these headers out of the PCH and replacing them with a single cppwinrt module, built once and shared between projects, the PCHs shrunk by upwards of 80%, and the time to build each PCH went from ~40 seconds down to ~5 seconds. The single prebuilt cppwinrt modules carried all of the types for the entire Windows.* namespaces and WinUI, and still consumed only 700MB, and took ~80-90 seconds to build. Excluding unused namespaces from the module build can lower those numbers even further. The Terminal prototype didn't do this, and still enjoyed immediate wins on disk space, and the build time wins broke even after converting about 2-3 projects out of the ~15 or so that use C++/WinRT.
As part of this large effort, we no longer generate the old monolithic module interface file winrt.ixx, but instead generate a module interface .ixx file for each WinRT namespace. There is more documentation at nuget/modules/md to help get you started.
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.250303.1...3.0.260520.1
Use actions/cache@v4 by @jsoref in https://github.com/microsoft/cppwinrt/pull/1411
actions/cache@v4 by @jsoref in https://github.com/microsoft/cppwinrt/pull/1411observable_map_base::call_changed to protected by @Patschkowski in https://github.com/microsoft/cppwinrt/pull/1425<exception> to base_includes.h by @m417z in https://github.com/microsoft/cppwinrt/pull/1427Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.240405.15...2.0.250303.1
d2a6677 Remove references to stale winmd files to fix incremental builds
This list of changes was auto generated.
d2a66776bb16e1da9dac60770c977e847485e24b Remove references to stale winmd files to fix incremental builds (#1404)
e03bdc4e3987b8eb1425b9fe4f2ebbba548be423 Use latest upload/download actions (#1410)
17d095ac936f21007ef94f9594aec52d250240a6 Fix build following dependabot updates (#1409)
2b8fe6e000ea9ce4402e97fa85c3919fe9a81281 Revert "Bump actions/upload-artifact from 3 to 4 (#1407)"
ea187691c1c0d508399c1b069635383082fd9e5b Bump actions/download-artifact from 3 to 4 (#1408)
6f7495288c4a90b29e95808ab08a0489f7d94f72 Bump actions/upload-artifact from 3 to 4 (#1407)
523eda71a6fdd73534c7910b974554ac9850830f Bump actions/stale from 6 to 9 (#1405)
dfad7ed2cae3f4d6e5c5f07c2416804245c98409 Bump actions/checkout from 3 to 4 (#1406)
f0ce6c67980f4617340282c352aabfef8dbdc41b Create dependabot.yml
adc6ef93185b2fa40e5f89d99fcd59b8b856dec7 TDBuild - updating localized resource files. <details><summary><b>See More</b></summary>
bdf6dc462bf6b827d7c8ce893e725faf5acba6b0 Merlinbot baseline (#1401)
6dccf9ef884a6b1613f14682d8ae181563a00559 Pipeline changes to build, publish, and test (#1400)
e69ff22721f9fb968a18d8da6ef67d062a9e5db1 Remove dead code related to Windows 7 support (#1390)
91f485fbf2291da083f4360a098dfc2e57475026 Remove double forward (#1387)
2bfcd7524af95087dcb60ce550dbc046f9ccec27 Fail gracefully when error reporting is suppressed (#1386)
This list of changes was auto generated.</details>
25a14f8 Update build.yml for Azure Pipelines ( #1384 ) [ #1338 ]
resume_agile to allow coroutine to resume in any apartment (#1356)shared_ptr and weak_ptr (#1330)This list of changes was auto generated.
25a14f89655ffdbaa85fa9e0e797de7ddc340dac Update build.yml for Azure Pipelines (#1384) [ #1338 ]
cb674723b42b830215156ccb032533c0e3092c28 CppWinRTAddXamlReferences to not use outputs as inputs (#1381)
5ef408f8b068f6311b86f0f7a52842fb94485810 User/dmachaj/slim source location (#1379)
2511bf7fcb54a64c1e596a950788e2ee30cd1e4c Update pool (#1374)
fc587f31f94481b7e71306d84354d545d4dd8642 Allow delegates to be created with weak reference + lambda (#1372) [ #1371 ]
912aa47ff43e0379e89d10dcb0d470bd360d17e3 Update GitHub action LLVM version to 17.0.5 (#1373)
bf4459b25aeeb7093e8262fb3b29ca70b0ab2e60 Allow resume_agile to be stored in a variable (#1358)
fac72c82b09ea1501a2c2eb6c00fd8cd89363392 Add resume_agile to allow coroutine to resume in any apartment (#1356)
23c4ced66ac1672a2326eec3e6b1c24f42353c3c Improve GCC compatibility (#1352)
691f6f8c9d6cbdde5ba99363a26f0f8a8486dd13 Support for std::span for winrt::array_view and winrt::com_array (#1343) <details><summary><b>See More</b></summary>
de6ca88bd6a36cb6d6fc936a649a49b816b12d60 Remove old Windows 7 support code (#1348)
9b453cfc518bdaa7e2ff590526c4883457fd6065 Enable faster dev cycle in Visual Studio (#1340) [ #1341 ]
4196e08bd2907707def400f8f83f176359d4adea Increase foldability of various templates (#1338)
0958cf3a4d572b54d14a06e9d506a1ddd09fae2e Hide protected and overridable members from public projections (#1319)
953d65cc85d5fb75986c4bcdb024f4906a367ee0 Register event handlers with shared_ptr and weak_ptr (#1330)
This list of changes was auto generated.</details>
297454e Allow classic COM interfaces with get_self ( #1314 ) [ #1312 ]
This list of changes was auto generated.
This list of changes was auto generated.
0e740b1bae4578ce0c5b2ff9b7778fee167160e7 Update issue template to use cpp instead of rust
cpp instead of rust (#1313)This list of changes was auto generated.
45872647571996c6bb8dad944994456d3383e255 Remove explicitly setting PreferredToolArchitecture, since VS 2022 handles this more comprehensively
capture support for unconventional result types (#1301)This list of changes was auto generated.
Stack usage reduction in apartment switching, and lifetime fixes by @oldnewthing in https://github.com/microsoft/cppwinrt/pull/1272
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.230207.1...2.0.230225.1
Fix llvm-mingw tests with LLVM trunk by @alvinhochun in https://github.com/microsoft/cppwinrt/pull/1235
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.221121.5...2.0.230207.1
Enable more tests on llvm-mingw and some fixes by @alvinhochun in https://github.com/microsoft/cppwinrt/pull/1229
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.221117.1...2.0.221121.5
Projects with a nested Windows namespace (e.g., Microsoft::Windows) fail to compile by @Scottj1s in https://github.com/microsoft/cppwinrt/pull/1223
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.221101.3...2.0.221117.1
Nothing published for this version
Fix classic COM errors on non-supported compilers by @sylveon in https://github.com/microsoft/cppwinrt/pull/1194
Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.220929.3...2.0.221101.3
Upgrade cppwinrt solution to Visual Studio 2022 by @kennykerr in https://github.com/microsoft/cppwinrt/pull/1187
std::source_location support when logging error information by @dmachaj in https://github.com/microsoft/cppwinrt/pull/1185Full Changelog: https://github.com/microsoft/cppwinrt/compare/2.0.220912.1...2.0.220929.3
380cb8f773e1b9da8d947f6567eeaac401e0c33c Add explicit casts to atomic_ref_count
__uuidof without GUID (#1180)This list of changes was auto generated.
Nothing published for this version
4f0be70254efab15530feaf5fb4894ff56fe8617 Static events should not use the auto trick
This list of changes was auto generated.
a54d678bb4794b0727b23eb24846f99e56eaa77f IComponentConnector2 doesn't exist in WinUI
This list of changes was auto generated.
dcea885fd470786cb1a4c75f1bd881d000d6b329 Add support for composed implementations of IComponentConnector
auto trick to catch missing header files for auto_revoke (#1136)This list of changes was auto generated.
c4a8e24472cd652a6f85a8f71180d5ccc2569de5 Update C++/WinRT to consider the full contract version history for fast ABI
This list of changes was auto generated.
04008670da93091c27530484d18e50a0ef08b691 two-phase initialization support to prevent double-destruction on handing out this pointer in ctor
This list of changes was auto generated.
b69f40d6ecc7d852aebb0682e099322b60cc34e3 per request, provide implementation-side visualizations. and always show raw data.
This list of changes was auto generated.
e0012b04cd3833c944984e681633df5fde6311ae Remove workaround for Visual C++ code gen bug
WINRT_IMPL_AUTO workaround (#1117)This list of changes was auto generated.
0e33676e6d6c17d6a43e1ded9c94286305e77358 Add guid brace parsing
Windows.Foundation.Numerics.Rational (#1106)This list of changes was auto generated.
24650deabbddf72f18c3f74b4884672c9ddecf60 Fix weak references to coroutines
Windows::UI::Color (#1095)This list of changes was auto generated.
1ab11a3522fe3a6fcccc7e1f5b7187a9692c0033 More reliable verbose path output
1ab11a3522fe3a6fcccc7e1f5b7187a9692c0033 More reliable verbose path output (#1091)
51ec25ce5c657048fa552f3054d7427137c9d9ea Make winrt::event clearable (#1074)
b8dcbbfeb0f005fdb49ff7f72f1525c09a7a58f2 TDBuild - updating localized resource files.
74a401dd848552b66f978bb4646f5afae8d18146 TDBuild - updating localized resource files.
acf7188bed36ccadb4c7f353539381e07753fab9 Minor updates to binaries to enable tooling scans (#1077)
8be3a88896bb367f15950235755493dbf24d7b12 TDBuild - updating localized resource files.
a8dbc8842e148d9f067c7388b9f8c3d39b506e2f Onboard to localization build (#1075)
0be01db74002bcbb6c9bcc3fd6f0ef88961bf71b Fix compilation under Clang (#1073)
4d5c5ae3de386ce1f18c3410a27b9ceb40aa524d Lay groundwork for localizing VSIX templates and remove Dev15 build cruft (#1060)
c28713d626b0e4816c2790248aa577269fdcf3a3 Remove WINRT_NO_MAKE_DETECTION from project templates (#1067) <details><summary><b>See More</b></summary>
e1920949fd38bd168469d0ea665bafafbb775234 Allow non-void static setter methods when compiling with -opt (#1063)
This list of changes was auto generated.</details>
Nothing published for this version
Nothing published for this version
bddd2e1303ecdf4c26e4721cc6b66a58b37d9949 Improved struct ordering
This list of changes was auto generated.
24af032f484ffc363b528c558732ca8b246900f1 Support binding std::optional implementation to IReference parameters
This list of changes was auto generated.
4e6eed2fa37f96c02c6329d5540e64a6e1f666d1 Simplify use of WINRT_NO_MODULE_LOCK in DLLs
WINRT_NO_MODULE_LOCK in DLLs (#1032)This list of changes was auto generated.
71832b634d12271d540383df35bde0ea1c69156c std::format support
This list of changes was auto generated.
1c07e1b7dba43b9044307e57d12396c11767daac Avoid exception in observable IndexOf implementation
This list of changes was auto generated.
f2f08f72b66a9fe18dfedd272e224ba109811f4e Ignore errors during manual unregistration
co_await were not protected by WINRT_IMPL_COROUTINES (#1002)This list of changes was auto generated.
4ba22a67d7fb24d2ae0c0472d3cdaaeb4b013465 Use throw rather than abort() for guid parse failures
This list of changes was auto generated.
00bc3b8f593790a157078181830c80e2639d112b Harden put functions against misuse
This list of changes was auto generated.
c97862759284e786f8c4e1c11cd09d89bf90c553 Ensure the Xaml designer can find out WinMD
This list of changes was auto generated.
74240c8cd6c9e55a44aab4c0cf451ff23e8c42a6 Ensure we don't override XamlLanguage if it's already set.
This list of changes was auto generated.
54c1097dac93759058e8abf29b337ca70c307148 Fix target override as it doesn't work when the target import order changes.
This list of changes was auto generated.
7e730e7652a42754bd0384feb7c84d5484daff2e Revert "Prevent inadvertent assignment to temporary object"
7e730e7652a42754bd0384feb7c84d5484daff2e Revert "Prevent inadvertent assignment to temporary object" (#976)
634d6275579dc8e5c373a6fbc89d9f4f4eefa9a4 Update VSIX to work with Dev17 (#968)
837ac89ca52f00e2ef1fdd8c0009c801c5f8176f check_hresult returns the hresult as a convenience (#971)
8fb1e2147ef5b49985f205c71254eabee5757963 Ingest updated winmd library to fix include/exclude regression (#969)
933a28b223e43f89c1d7c38a6aab09d8f38e039a Fix delegates with return value passed as fptr or {p,mfptr} (#966)
186f53ee4288499889db683c2b7a8061afd9c2fb IReference operators in level-1 header should be forward declarations (#965)
fb3e9897ad15dd44cff2ec0f7e273878d7b0fe67 Add starts_with and ends_with to hstring (#952)
b0b9bf74363546b76d63592fe4a32d1a7e6bfded Add IMemoryBufferByteAccess accessor (#956)
9e4fdedbe496bc42d94fb77c43245cbb6cf9bd71 Adds synchronous option to avoid I/O issues in batch builds (#961)
7ddfc798e34bff89d3da8a5b704f1103f1ec2a7f Improve diagnostics when implements<> is used incorectly (#959) <details><summary><b>See More</b></summary>
06ae44406d339f7e2887ed7b8f61e9edbde4b6a0 Add deduction guides for agile_ref and weak_ref (#955)
f204e39d293c3c54dc1df65f05ed6a9c650ac6b1 Add #pragma once in addition to header guard (#948)
0d94a2e275bc9a5ecd87fc114a06882ca8ccadf3 Project templates should not set DisableSpecificWarnings to empty. (#949)
d6bbe13deea4bb3e616c0b2331fd8de884ee05eb Make the v142 toolset the default. (#946)
This list of changes was auto generated.</details>
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
1c4b5f558dd90b30c1e1c183d608c317c3139df6 Ingest updated Microsoft.Windows.WinMD to fix bug around "-exclude"
This list of changes was auto generated.
2e05b07d3195ba50ecb19acba8ab1084e6b7dc9f Add switch to disable merge validation to support certain test scenarios
This list of changes was auto generated.
969ea267c1063e63a7c5e7a6d2481c7241772c09 Update .targets file to support local servers
This list of changes was auto generated.
18670d249d019ccb860853b753f23a3f5fbbacb6 Runtime class name for bare IInspectable should not be "Object"
This list of changes was auto generated.
3d80b918d9cb85b52f777a282af8b3dbeaea09ae Natvis support for hresult_error and array_view
This list of changes was auto generated.
5e1b063525ef3cc96506859f564c1cef6fa521c0 IReference operators need to go into the level-1 header
This list of changes was auto generated.
122b732393d2f916367c06fd026f79d8ac4cee43 Windows test
This list of changes was auto generated.
1935608ceb28860f2e89451eed84230b4dd69646 Support nested Windows namespace
This list of changes was auto generated.
c70d9382d647bf7545610346000d92a29951987c Fix support for x86 builds with Clang
This list of changes was auto generated.
0cd75f40d3d5fc8385c30dc261bc85d02c6d2cb7 use app manifest
This list of changes was auto generated.
7ec62b76400246f8ced24d04b75ee6a499596715 Reduce size of compiled base.h due to get_runtime_activation_factory
This list of changes was auto generated.
fc9b4d780f389dec229bb9efe6f04b8aaa099273 abort
This list of changes was auto generated.
c350ff38d526f138115bae16fb0a0ebca9b99f1d Clang workarounds
This list of changes was auto generated.
One column per quarter.