Share via

RoActivateInstance 関数 (roapi.h)

  • [アーティクル]

指定したWindows ランタイム クラスをアクティブにします。

構文

HRESULT RoActivateInstance(
  [in]  HSTRING      activatableClassId,
  [out] IInspectable **instance
);

パラメーター

[in] activatableClassId

型: HSTRING

アクティブ化可能なランタイム クラスに関連付けられているクラス識別子。

[out] instance

種類: IInspectable**

ランタイム クラスのアクティブ化されたインスタンスへのポインター。

戻り値

種類: HRESULT

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 クラスが正常にアクティブ化されました。
E_POINTER
 インスタンス が NULL です。
CO_E_NOTINITIALIZED
 スレッドは、RoInitialize 関数を呼び出してWindows ランタイムで初期化されていません。
E_ACCESSDENIED
 クラスの TrustLevel には、完全信頼プロセスが必要です。
E_NOINTERFACE
 IInspectable インターフェイスは、指定されたクラスによって実装されません。
E_OUTOFMEMORY
 クラスのインスタンスを作成できませんでした。

注釈

RoActivateInstance 関数を使用して、Windows ランタイム クラスをアクティブ化します。 RoActivateInstance 関数は、指定したアクティブ化可能なクラス識別子に関連付けられているアクティブ化ファクトリに接続し、クラスで引数 0 のコンストラクターを呼び出してインスタンスを作成し、アクティブ化ファクトリを解放します。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー roapi.h

こちらもご覧ください

Cocreateinstance

IActivationFactory

IInspectable

TrustLevel