winrt::create_instance 関数テンプレート (C++/WinRT)
指定した CLSID に関連付けられたクラスの初期化されていないオブジェクトを 1 つ作成し、 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 If nullptrは、オブジェクトが集計の一部として作成されていないことを示します。 そうでない nullptr場合は、集計オブジェクトの IUnknown インターフェイス (制御する IUnknown) へのポインター。
戻り値
新しく作成されたオブジェクトの winrt::com_ptr 。 成功しなかった場合はスローされます。
必要条件
サポートされている最小 SDK: Windows SDK バージョン 10.0.17134.0 (Windows 10、バージョン 1803)
名前空間: winrt
ヘッダー: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (既定で含まれます)