winrt 命名空间 (C++/WinRT)

winrt 命名空间提供属于 C++/WinRT 的自定义数据类型，这是适用于 Windows 运行时 (WinRT) API 的标准新式 C++17 语言投影。 这些自定义类型提供与标准类型的适当转换，以便你大部分时间都可以继续使用你习惯使用的标准 C++ 语言功能和已有的源代码。

winrt 命名空间中还提供了用于创建运行时类实例、装箱和取消装箱等 (函数，) 、智能指针和其他因素。

winrt 命名空间中的类型

类型	说明
agile_ref 结构模板	表示对 C++/WinRT 对象或接口的敏捷引用的类型。
apartment_context 结构	捕获协同例程中的线程上下文，以便以后可以还原它。
array_view 结构模板	连续一系列值的视图或范围。
auto_revoke_t 标记结构	一种标记类型，用于在注册委托以处理事件时请求事件撤销程序。
隐藏标记结构模板	用于指示不应由 IInspectable：：GetIids 报告实现的接口的标记类型
clock 结构	一种类型，它包含静态帮助程序函数，用于将 Windows：：Foundation：:D ateTime (（即 std：：chrono：：time_point) 与 winrt：：file_time 以及从 winrt：：file_time 转换到 和转换time_t）。
com_array 结构模板	用于传入和传递Windows 运行时 API 的连续系列值的视图或范围。
com_ptr 结构模板	引用计数的 COM 智能指针模板。
可组合标记结构	用于指示类型可以是可组合类的内部类的标记类型。
撰写标记结构	用于指示类型是可组合类的外部类的标记类型。
deferrable_event_args	一种可用于实现 (生成) 可延迟事件模式的类型。
delegate 结构模板	一种类型，可用于为你自己的事件声明自定义委托类型。
event 结构模板	可用于声明和实现指定委托类型的事件的类型。
event_revoker 结构模板	注册委托时，可以请求事件撤销程序，该撤销程序可用于自动或手动撤销委托。
event_token 结构	向事件注册事件处理委托时返回的令牌;可用于撤销同一委托的注册。
file_handle 结构	表示 Windows 文件句柄对象。
fire_and_forget 结构	使用此返回类型使协同例程成为即发即弃。
guid 结构	表示 GUID) (全局唯一标识符。
handle 结构	表示 Windows 句柄对象。
handle_type 结构模板	winrt：：handle 和 winrt：：file_handle 结构的模板。
hstring 结构	表示文本字符串的 UTF-16 Unicode 字符的顺序集合。
hresult_access_denied 结构	派生自 winrt：：hresult_error 的类型，表示E_ACCESSDENIED HRESULT 错误代码。
hresult_canceled 结构	派生自 winrt：：hresult_error 的类型，表示ERROR_CANCELLED HRESULT 错误代码。
hresult_changed_state 结构	派生自 winrt：：hresult_error 的类型，表示E_CHANGED_STATE HRESULT 错误代码。
hresult_class_not_available 结构	派生自 winrt：：hresult_error 的类型，表示CLASS_E_CLASSNOTAVAILABLE HRESULT 错误代码。
hresult_error 结构	表示 HRESULT 错误代码的类型。
hresult_illegal_delegate_assignment 结构	派生自 winrt：：hresult_error 的类型，表示E_ILLEGAL_DELEGATE_ASSIGNMENT HRESULT 错误代码。
hresult_illegal_method_call 结构	派生自 winrt：：hresult_error 的类型，表示E_ILLEGAL_METHOD_CALL HRESULT 错误代码。
hresult_illegal_state_change 结构	派生自 winrt：：hresult_error 的类型，表示E_ILLEGAL_STATE_CHANGE HRESULT 错误代码。
hresult_invalid_argument 结构	派生自 winrt：：hresult_error 的类型，表示E_INVALIDARG HRESULT 错误代码。
hresult_no_interface 结构	派生自 winrt：：hresult_error 的类型，表示E_NOINTERFACE HRESULT 错误代码。
hresult_not_implemented 结构	派生自 winrt：：hresult_error 的类型，表示E_NOTIMPL HRESULT 错误代码。
hresult_out_of_bounds 结构	派生自 winrt：：hresult_error 的类型，表示E_BOUNDS HRESULT 错误代码。
hresult_wrong_thread 结构	派生自 winrt：：hresult_error 的类型，表示RPC_E_WRONG_THREAD HRESULT 错误代码。
实现结构模板	代表派生类型实现一个或多个Windows 运行时接口的基本结构模板。
map_base 结构模板	一个基类，供你从中派生，表示不可观察的关联集合。
map_view_base 结构模板	派生自 的基类，表示关联集合中连续元素序列的视图。
no_module_lock标记结构	用于指示类型的实例不计入模块对象计数的标记类型。
no_weak_ref 标记结构	用于选择退出弱引用支持的标记类型。
non_agile 标记结构	标记类型，用于指示类型不是敏捷的，因此不实现 IAgileObject 接口。
observable_map_base 结构模板	派生自 的基类，表示可观测的关联集合。
observable_vector_base 结构模板	一个基类，供你从中派生，表示可观测向量。
static_lifetime 标记结构	用于将激活工厂选择为静态生存期的标记类型。
vector_base 结构模板	一个基类，供你从中派生，它表示一个不可观察的常规用途集合，称为向量。
vector_view_base 结构模板	一个基类，可从中派生，以实现自己的常规用途集合中元素序列的自定义视图或范围。
weak_ref 结构模板	表示对 C++/WinRT 对象或接口的弱引用的类型。
Windows::Foundation::IUnknown 结构	每个 C++/WinRT 运行时类 (windows 或第三方运行时类) 派生自 winrt：：Windows：：Foundation：：IUnknown。

winrt 命名空间中的函数

函数	说明
attach_abi 函数	将 C++/WinRT 对象附加到句柄或原始指针的帮助器函数，该指针拥有对其目标的引用。
box_value 函数模板	一个函数模板，用于将 (或 框 包装) 引用类对象中的标量或数组值，以便可以将其传递给需要 IInspectable 的函数。
capture 函数模板	一个函数模板，用于调用指定的函数或方法，捕获生成的接口指针，并将其作为 winrt：：com_ptr返回。
check_bool 函数模板	一个帮助器函数，用于检查值是否为 false，如果是，则检索调用线程的最后错误代码值，并使用表示该错误代码的 C++/WinRT 对象引发异常。
check_hresult 函数	一个帮助程序函数，用于检查 HRESULT 代码是否表示错误，如果是，则使用表示错误代码的 C++/WinRT 对象引发异常。
check_nt 函数模板	一个帮助器函数，用于检查代码是否表示错误，如果是，请将错误代码的 NT 状态值映射到 HRESULT 值，并使用表示错误代码的 C++/WinRT 对象引发异常。
check_pointer 函数模板	一个帮助器函数，用于检查指针是否为 null，如果是，则检索调用线程的最后错误代码值，并使用表示该错误代码的 C++/WinRT 对象引发异常。
check_win32 函数模板	一个帮助器函数，用于检查代码是否表示错误，如果是，则将值的系统错误代码映射到 HRESULT 值，并使用表示错误代码的 C++/WinRT 对象引发异常。
copy_from_abi 函数	一个帮助器函数，用于从句柄或原始指针复制到 C++/WinRT 对象。
copy_to_abi 函数	一个帮助器函数，用于从 C++/WinRT 对象复制到句柄或指针。
create_instance 函数模板	一个函数模板，用于创建与指定 CLSID 关联的类的单个未初始化对象，并将其作为 winrt：：com_ptr 返回，如果未成功，则引发。
detach_abi 函数	一个帮助器函数，用于将 C++/WinRT 对象与其引用的句柄或引用的接口分离。
from_abi 函数模板	给定投影类型的对象时，帮助器函数检索指向实现的指针。
get_abi 函数	一个帮助器函数，用于检索指向 C++/WinRT 对象的基础 IUnknown 接口的指针。
get_activation_factory 函数模板	一个帮助程序函数，用于检索指定Windows 运行时类类型的激活工厂。
get_cancellation_token 函数	在协同例程中，使用 winrt：：get_cancellation_token 返回的对象轮询取消或响应取消。
get_class_name 函数	一个帮助程序函数，用于检索包含指定Windows 运行时类的完全限定类型名称的字符串。
get_interfaces 函数	一个帮助器函数，用于检索包含由 C++/WinRT 对象实现的接口标识符的数组。
get_progress_token 函数	在协同例程中，使用 winrt：：get_progress_token 返回的对象将进度报告回进度处理程序。
get_self 函数模板	给定投影类型的对象时，帮助器函数检索指向实现的指针。
get_trust_level 函数	一个帮助器函数，用于检索 C++/WinRT 对象的信任级别。
get_unknown 函数	一个帮助器函数，返回投影类型对象的基础原始 IUnknown 接口 的地址。
guid_of 函数模板	一个帮助程序函数模板，用于检索运行时类、coclass 或接口的 GUID。
is_guid_of 函数模板	一个帮助程序函数模板，用于确定提供的 GUID 是否是指定的运行时类、共同类或接口之一。
make 函数模板	一种工厂方法，当使用相应的实现类型进行参数化时返回投影类型或接口的实例。
make_agile 函数模板	返回 agile_ref 对象的帮助程序函数，表示对 C++/WinRT 对象或接口的敏捷引用。
make_self 函数模板	一种工厂方法，该方法将 com_ptr 返回到运行时类的实现类型的实例。
make_weak 函数模板	返回 weak_ref 对象的帮助程序函数，表示对 C++/WinRT 对象或接口的弱引用。
name_of 函数模板	一个帮助程序函数，用于检索包含特定Windows 运行时类的完全限定类型名称的字符串视图。
put_abi 函数	一个帮助程序函数，用于检索 C++/WinRT 对象的基础 IUnknown 接口指针的地址，以便可以将其设置为另一个值。
resume_after 函数	一个帮助程序函数，它向调用方返回控制权，然后在延迟后在线程池线程上恢复执行。
resume_background 函数	一个帮助程序函数，它向调用方返回控制权，并恢复在线程池线程上的执行。
resume_foreground 函数	一个帮助程序函数（用于协同例程内），可将 co_await 执行切换到特定前台线程。
resume_on_signal	一个函数，可用于挂起，直到发出内核事件信号。
single_threaded_map 函数模板	一个函数模板，用于创建并返回类型的对象，该对象实现不可观测的关联集合 (映射) 。 对象作为 IMap 返回。
single_threaded_observable_map 函数模板	一个函数模板，用于创建并返回类型的对象，该对象实现可观测关联集合 (映射) 。 对象作为 IObservableMap 返回。
single_threaded_observable_vector 函数模板	一个函数模板，用于创建并返回实现可观测集合的类型的对象。 对象作为 IObservableVector 返回。
single_threaded_vector 函数模板	一个函数模板，用于创建并返回实现常规用途集合的类型的对象。 对象作为 IVector 返回。
swap 函数	一个帮助程序函数，用于交换两个值的内容。
throw_hresult 函数	一个帮助程序函数，它采用 HRESULT 错误代码，并使用表示该错误代码的 C++/WinRT 对象引发异常。
throw_last_error 函数	一个帮助程序函数，用于检索调用线程的最后错误代码值，并使用表示该错误代码的 C++/WinRT 对象引发异常。
to_hresult 函数	一个帮助程序函数，用于 catch 块，它将引发的最后一个异常转换为 HRESULT 错误代码。
to_hstring 函数	一个帮助器函数，用于将输入值转换为包含值的字符串表示形式的 winrt：：hstring 。
to_string 函数	一个帮助器函数，用于将输入宽字符串转换为包含 UTF-8 窄字符串 的 std：：string 。
try_capture 函数模板	调用指定函数或方法的函数模板，捕获从函数或方法输出的接口指针，并在不成功的情况下将其返回为 winrt：：com_ptr 或空 com_ptr 。
try_create_instance 函数模板	一个函数模板，用于创建与指定 CLSID 关联的类的单个未初始化对象，如果失败，则将其返回为 winrt：：com_ptr 或空 com_ptr 。
try_get_activation_factory 函数模板	一个帮助程序函数，用于检索指定Windows 运行时类类型的激活工厂，如果未成功，则检索空com_ptr。
unbox_value 函数模板	从引用类对象内部) 标量或数组值，以便可以在需要 IInspectable 的函数中处理 (或取消装箱的函数模板。
unbox_value_or 函数模板	打开 (或 取消装箱 的函数模板) 引用类对象内部的标量值，并使用回退值，以便在需要 IInspectable 的函数中处理它。
xaml_typename 函数模板	一个帮助程序函数，以 Windows：：UI：：Xaml：：Interop：：TypeName 对象的形式返回Windows 运行时类型的类型名称。

扩展Windows 运行时 API 的 C++/WinRT 函数

某些Windows 运行时 API 的 C++/WinRT 投影类型上存在扩展函数。 例如， winrt：：Windows：：Foundation：：IAsyncAction 是 IAsyncAction 的 C++/WinRT 投影类型。 扩展函数不是应用程序二进制接口的一部分， (ABI) 实际Windows 运行时类型的图面，因此它们不会列为Windows 运行时 API 的成员。 但可以从任何 C++/WinRT 项目中调用它们。

WinRT API	函数	描述
IAsyncAction	get、 wait_for	请参阅 IAsyncAction C++/WinRT 扩展函数
IAsyncActionWithProgress	get、 wait_for	请参阅 IAsyncActionWithProgress C++/WinRT 扩展函数
IAsyncOperation	get、 wait_for	请参阅 IAsyncOperation C++/WinRT 扩展函数
IAsyncOperationWithProgress	get、 wait_for	请参阅 IAsyncOperationWithProgress C++/WinRT 扩展函数
IBindableIterable	begin， end	请参阅 IBindableIterable C++/WinRT 扩展函数
IBindableIterator	begin， end， operator++， operator++ (int) ， operator*	请参阅 IBindableIterator C++/WinRT 扩展函数
IBuffer	data	请参阅 IBuffer C++/WinRT 扩展函数
IIterable	begin， end	请参阅 IIterable C++/WinRT 扩展函数
IIterator	operator++， operator++ (int) ， operator*	请参阅 IIterator C++/WinRT 扩展函数
IKeyValuePair	operator==	请参阅 IKeyValuePair C++/WinRT 扩展函数
Imap	begin、 end、 TryLookup、 TryRemove	请参阅 IMap C++/WinRT 扩展函数
IMapView	begin、 end、 TryLookup	请参阅 IMapView C++/WinRT 扩展函数
IMemoryBufferReference	data	请参阅 IMemoryBufferReference C++/WinRT 扩展函数
IVector	begin， end	请参阅 IVector C++/WinRT 扩展函数
IVectorView	begin， end	请参阅 IVectorView C++/WinRT 扩展函数

其他函数

函数	说明
GetRuntimeClassName 函数	成员函数 (生成的实现类型) ，该实现类型返回包含要实现的Windows 运行时类的完全限定类型名称的字符串。

请参阅

C++/WinRT