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 杂志文章 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 值，其句柄与其他参数的句柄相互交换。