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 (默认包含)

请参阅