winrt::try_create_instance函数模板 (C++/WinRT)
一个函数模板,用于创建与指定 CLSID 关联的类的单个未初始化对象,并在未成功的情况下将其作为 winrt::com_ptr 或空 com_ptr 返回。
语法
template <typename Interface>
winrt::com_ptr<Interface> try_create_instance(guid const& clsid,
uint32_t context = 0x1 /*CLSCTX_INPROC_SERVER*/,
void* outer = nullptr);
模板参数
typename Interface
要查询新创建的对象的接口指针的类型。
parameters
clsid
与用于创建对象的数据和代码关联的 CLSID。
context
管理新创建对象的代码将在其中运行的上下文。 这些值取自枚举 CLSCTX。
outer
如果 nullptr
,则指示对象不是作为聚合的一部分创建的。 nullptr
否则,指向聚合对象的 IUnknown 接口的指针 (控制 IUnknown) 。
返回值
新创建的对象的 winrt::com_ptr ,如果未成功,则 为空com_ptr 。
要求
支持的最低 SDK:Windows SDK 版本 10.0.17134.0 (Windows 10版本 1803)
命名空间: winrt
标头: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (默认包含)