共用方式為


winrt::create_instance 函式範本 (C++/WinRT)

函式範本,它會建立與指定 CLSID 相關聯之類別的單一未初始化物件,並在未成功時以 winrt::com_ptr 傳回它,或擲回 。

語法

template <typename Interface>
winrt::com_ptr<Interface> create_instance(guid const& clsid,
    uint32_t context = 0x1 /*CLSCTX_INPROC_SERVER*/,
    void* outer = nullptr);

範本參數

typename Interface 要在新建立的物件上查詢的介面指標類型。

參數

clsid 與將用來建立物件之資料和程式碼相關聯的 CLSID。

context 管理新建立之物件的程式碼將執行的內容。 這些值取自列舉 CLSCTX

outer 如果 nullptr 為 ,表示物件未建立為匯總的一部分。 如果不是 nullptr ,則為匯總物件的 IUnknown 介面指標, (控制 IUnknown) 。

傳回值

新建立物件的 winrt::com_ptr 。 如果失敗,則會擲回 。

規格需求

最低支援的 SDK:Windows SDK 10.0.17134.0 版 (Windows 10版本 1803)

命名空間: winrt

標頭: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)

另請參閱