winrt::detach_abi function (C++/WinRT)
A helper function that detaches a C++/WinRT object from its referenced handle, or from its referenced interface. Detaching from an interface is done without decrementing the reference count, perhaps to return it to a caller. For more info, and code examples, see Interop between C++/WinRT and the ABI.
Syntax
template <typename T, typename =
std::enable_if_t<!std::is_base_of_v<winrt::Windows::Foundation::IUnknown, std::decay_t<T>>
&& !std::is_convertible_v<T, std::wstring_view>>>
auto detach_abi(T&& object);
inline void* detach_abi(winrt::Windows::Foundation::IUnknown& object) noexcept;
inline void* detach_abi(winrt::Windows::Foundation::IUnknown&& object) noexcept;
constexpr void* detach_abi(std::nullptr_t) noexcept;
template <typename T>
void* detach_abi(winrt::com_ptr<T>& object) noexcept;
inline void* detach_abi(winrt::hstring& object) noexcept;
inline void* detach_abi(winrt::hstring&& object) noexcept;
inline void* detach_abi(std::wstring_view const& value);
inline void* detach_abi(std::wchar_t const * const value);
template <typename T>
std::pair<uint32_t, void*> detach_abi(winrt::com_array<T>& object) noexcept;
template <typename T>
std::pair<uint32_t, void*> detach_abi(winrt::com_array<T>&& object) noexcept;
Parameters
object
A C++/WinRT object to operate on.
Return value
The handle, or a pointer to the raw interface, referenced by the C++/WinRT object.
Requirements
Minimum supported SDK: Windows SDK version 10.0.17134.0 (Windows 10, version 1803)
Namespace: winrt
Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)