winrt：：handle_type結構範本 （C++/WinRT）
winrt：：handle 和 winrt：：file_handle 結構等範本。
注意
您可以定義自己的句柄特性（例如，在 \cppwinrt\winrt\base.h中定義 handle_traits 或 file_handle_traits），並以 winrt：：handle_type 作為 typename T使用。 將其中一個範例從 base.h 複製到您自己的原始碼檔案，並提供您自己的句柄類型和實作。 MSDN Magazine 文章中有更多詳細數據，Windows C++。
語法
template <typename T>
struct handle_type
範本參數
typename T 指定所表示句柄類型的特性類型（句柄、檔句柄或其他類型）。
要求
最低支援的 SDK： Windows SDK 10.0.17134.0 版（Windows 10 版本 1803）
Namespace： winrt
標頭： %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h （預設包含）
成員類型別名
| 別名名稱 | 類型 |
|---|---|
| handle_type：：type |
typename T：：type同義字，其中 T 是 typename T 範本參數。 |
構造 函數
| 構造 函數 | 描述 |
|---|---|
| handle_type：：handle_type建構函式 | 使用輸入數據的複本或移動，初始化 handle_type 結構的新實例。 |
成員函式
| 功能 | 描述 |
|---|---|
| handle_type：：attach 函式 | 附加至句柄值，並取得其擁有權。 |
| handle_type：：close 函式 | 關閉基礎句柄。 |
| handle_type：:d etach 函式 | 從基礎句柄中斷連結。 |
| handle_type：：get 函式 | 如果您需要將它傳遞至函式，傳回基礎句柄。 |
| handle_type：:p ut 函式 | 傳回基礎句柄的位址;此函式可協助您呼叫方法，透過句柄的指標傳回參考做為 out 參數。 |
成員運算子
| 算子 | 描述 |
|---|---|
| handle_type：：operator bool | 檢查 handle_type 物件目前是否代表有效的句柄。 |
| handle_type：：operator= （指派運算符） | 將值指派給 handle_type 物件。 |
免費函式
| 功能 | 描述 |
|---|---|
| 交換函式 | 交換兩個 handle_type 參數的內容，使其包含彼此的句柄。 |
handle_type：：handle_type建構函式
使用輸入數據的複本或移動，初始化 handle_type 結構的新實例。
語法
handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;
參數
value 初始化 handle_type 物件的 值。
other 另一個初始化 handle_type 物件的 handle_type。
handle_type：：attach 函式
附加至句柄值，並取得其擁有權。
語法
void attach(handle_type::type value) noexcept;
參數
value 要附加的句柄值。
handle_type：：close 函式
關閉基礎句柄。
語法
void close() noexcept;
handle_type：:d etach 函式
從基礎句柄中斷連結。
語法
handle_type::type detach() noexcept;
傳回值
基礎句柄先前由 handle_type 物件表示。
handle_type：：get 函式
傳回基礎句柄，如果您需要將它傳遞至函式。
語法
handle_type::type get() const noexcept;
傳回值
handle_type 物件表示的基礎句柄。
handle_type：:p ut 函式
傳回基礎句柄的位址;此函式可協助您呼叫方法，透過句柄的指標傳回參考做為 out 參數。
語法
handle_type::type* put() noexcept;
傳回值
handle_type 物件所表示之基礎句柄的位址。
handle_type：：operator bool
檢查 handle_type 物件目前是否代表有效的句柄。
語法
explicit operator bool() const noexcept;
傳回值
如果 handle_type 物件目前代表有效的句柄，則 true，否則 false。
handle_type：：operator= （指派運算符）
將值指派給 handle_type 物件。
語法
winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;
參數
other 要指派給 handle_type 物件的 handle_type 值。
傳回值
handle_type 對象的參考。
swap 函式
交換兩個 handle_type 參數的內容，使其包含彼此的句柄。
語法
void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;
參數
left
right
handle_type 值，其句柄會與其他參數的句柄相互交換。