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 預設包含)