winrt：：weak_ref 結構範本 (C++/WinRT)

發行項
07/20/2023

類型，表示 C++/WinRT 物件或介面的弱式參考。如需詳細資訊以及程式碼範例，請參閱 C++/WinRT 中的強式和弱式參考。

Syntax

template <typename T>
struct weak_ref

範本參數

typename T C++/WinRT 物件的類型或介面的弱式參考，由 weak_ref 物件表示。這是弱式參考目標的類型。

規格需求

最低支援的 SDK：Windows SDK 10.0.17134.0 版 (Windows 10版本 1803)

命名空間： winrt

標頭： %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)

建構函式

建構函式	描述
weak_ref：：weak_ref 建構函式	使用輸入資料的複本，初始化 weak_ref 結構的新實例。

成員函數

函式	描述
weak_ref：：get 函式	遞增參考計數，並擷取 weak_ref 物件弱式參考的 C++/WinRT 物件或介面。判斷是否可以將 weak_ref 解析為強式參考的方式，就是呼叫 get 並嘗試。

成員運算子

運算子	描述
weak_ref：：operator bool	檢查 weak_ref 物件是否擁有弱式參考或 `nullptr` 。判斷是否可以將weak_ref 解析為強式參考的方式，就是呼叫 weak_ref：：get 並嘗試。

weak_ref：：weak_ref 建構函式

使用輸入資料的複本，初始化 weak_ref 結構的新實例。

語法

weak_ref(std::nullptr_t = nullptr) noexcept;
weak_ref(T const& object);
weak_ref(com_ptr<T> const& object);

參數

object 初始化 weak_ref 物件的 C++/WinRT 物件或介面或智慧型指標。

weak_ref：：get 函式

遞增參考計數，並擷取 weak_ref 物件弱式參考的 C++/WinRT 物件或介面。判斷是否可以將 weak_ref 解析為強式參考的方式，就是呼叫 get 並嘗試。

語法

auto get() const noexcept;

傳回值

由 weak_ref 物件弱式參考的 C++/WinRT 物件或介面，或者 nullptr 弱式參考的目標已終結。

weak_ref：：operator bool

檢查 weak_ref 物件是否擁有弱式參考或 nullptr 。判斷 是否可以將weak_ref 解析為強式參考的方式，就是呼叫 weak_ref：：get 並嘗試。

語法

explicit operator bool() const noexcept;

傳回值

true 如果 weak_ref 物件擁有弱式參考則為 ; false 如果 weak_ref 物件擁有，則為 nullptr 。