winrt::try_create_instance 関数テンプレート (C++/WinRT)

  • [アーティクル]

指定した CLSID に関連付けられたクラスの初期化されていないオブジェクトを 1 つ作成し、成功しなかった場合は 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 新しく作成された オブジェクトに対してクエリを実行するインターフェイス ポインターの型。

パラメーター

clsid オブジェクトの作成に使用されるデータとコードに関連付けられている CLSID。

context 新しく作成された オブジェクトを管理するコードが実行されるコンテキスト。 値は、列挙 CLSCTX から取得されます。

outer の nullptr場合、オブジェクトが集計の一部として作成されていない状態を示します。 ではない場合 nullptrは、集約オブジェクトの IUnknown インターフェイス (制御 する IUnknown) へのポインター。

戻り値

新しく作成されたオブジェクトcom_ptr winrt::com_ptr場合は空です。

要件

サポートされている最小 SDK: Windows SDK バージョン 10.0.17134.0 (Windows 10 バージョン 1803)

名前空間: winrt

ヘッダー: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (既定で含まれます)

関連項目