winrt::copy_from_abi 関数 (C++/WinRT)

ハンドルまたは生ポインターから C++/WinRT オブジェクトにコピーするヘルパー関数。 C++/WinRT オブジェクトをクリアするか、現在参照されているインターフェイスの参照カウントをデクリメントし、パラメーターをコピーし、そのインターフェイスが指すハンドルまたはインターフェイスの管理を開始します (パラメーターの参照カウントのインクリメントを含みます)。 詳細とコード例については、「 C++/WinRT と ABI の相互運用」を参照してください。

構文

template <typename T, typename V, typename =
std::enable_if_t<!std::is_base_of_v<winrt::Windows::Foundation::IUnknown, T>>>
void copy_from_abi(T& object, V&& value);

void copy_from_abi(winrt::hstring& object, void* value);

void copy_from_abi(winrt::Windows::Foundation::IUnknown& object, void* value) noexcept;

パラメーター

object 操作する C++/WinRT オブジェクト。

value ハンドル、または C++/WinRT オブジェクトによって有効期間を管理する必要があるターゲットへの生ポインター。 オーバーロードのIUnknown&, void*場合、関数はに対して AddRef を呼び出します。

必要条件

サポートされている最小 SDK: Windows SDK バージョン 10.0.17134.0 (Windows 10、バージョン 1803)

名前空間: winrt

ヘッダー: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (既定で含まれています)

こちらもご覧ください