{"id":109965,"date":"2024-07-11T07:00:00","date_gmt":"2024-07-11T14:00:00","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/oldnewthing\/?p=109965"},"modified":"2024-06-24T10:37:09","modified_gmt":"2024-06-24T17:37:09","slug":"20240711-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20240711-00\/?p=109965","title":{"rendered":"Creating an already-completed asynchronous activity in C++\/WinRT, part 3"},"content":{"rendered":"

Last time, we figured out how to create an already-completed asynchronous activity in C++\/WinRT<\/a>. Today we’ll try to generalize it to cover the four kinds of Windows Runtime asynchronous activities.<\/p>\n\n\n\n\n\n
 <\/td>\nNo progress<\/th>\nProgres<\/th>\n<\/tr>\n
No result<\/th>\nIAsyncAction<\/code><\/td>\nIAsyncActionWithProgress<P><\/code><\/td>\n<\/tr>\n
Result<\/th>\nIAsyncOperation<\/code><\/td>\nIAsyncOperationWithProgress<T, P><\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

One way to do this is to write four different functions for each category, similar to how we dealt with cv<\/i>-qualifiers before we had deducing this<\/a>.<\/p>\n

winrt::Windows::Foundation::IAsyncAction\r\nMakeCompletedAsyncAction()\r\n{\r\n    co_return;\r\n}\r\n\r\ntemplate<typename Progress>\r\nwinrt::Windows::Foundation::IAsyncActionWithProgress<Progress>\r\nMakeCompletedAsyncActionWithProgress()\r\n{\r\n    co_return;\r\n}\r\n\r\ntemplate<typename Result, typename Progress>\r\nwinrt::Windows::Foundation::IAsyncOperation<Result>\r\nMakeCompletedAsyncOperation(Result result)\r\n{\r\n    co_return result;\r\n}\r\n\r\ntemplate<typename Result, typename Progress>\r\nwinrt::Windows::Foundation::IAsyncOperationWithProgress<Result, Progress>\r\nMakeCompletedAsyncOperationWithProgress(Result result)\r\n{\r\n    co_return result;\r\n}\r\n\r\n\/\/ Sample usage:\r\n\r\nwinrt::Windows::Foundation::IAsyncOperation<int>\r\nGetHeightAsync()\r\n{\r\n    return MakeCompletedAsyncOperation(42);\r\n}\r\n\r\nwinrt::Windows::Foundation::\r\n    IAsyncOperationWithProgress<int, HeightProgress>\r\nGetHeightAsync()\r\n{\r\n    return MakeCompletedAsyncOperationWithProgress<\r\n        int, HeightProgress>(42);\r\n}\r\n<\/pre>\n
Explicit specialization is required for the WithProgress<\/code> versions, since there is no opportunity to deduce the progress type.<\/p>\n
We could combine the four flavors into a single function, though this means that specialization is mandatory.<\/p>\n
template<typename Async, typename... Result>\r\nAsync MakeCompleted(Result... result)\r\n{\r\n    if constexpr (sizeof...(Result) == 0) {\r\n        co_return;\r\n    } else {\r\n        static_assert(sizeof...(Result) == 1);\r\n        co_return std::get<0>(\r\n            std::forward_as_tuple(result...));\r\n    }\r\n}\r\n<\/pre>\n
We use a trick in Make\u00adCompleted<\/code> by formally accepting any number of arguments, although we check inside the function body that it is zero or one. In the case where there is one parameter, we use the forward_as_tuple<\/code> + get<\/code> technique to  pull a single item from a parameter pack<\/a>.<\/p>\n
Next time, we’ll try to write MakeFailed<\/code>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Generalizing to the four kinds of Windows Runtime asynchronous activities.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-109965","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Generalizing to the four kinds of Windows Runtime asynchronous activities.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/109965","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=109965"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/109965\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=109965"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=109965"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=109965"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}