RoActivateInstance 関数 (roapi.h)

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

構文

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

パラメーター

[in] activatableClassId

型: HSTRING

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

[out] instance

型: IInspectable**

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

戻り値

型: HRESULT

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

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

注釈

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

Requirements

Requirement	価値
サポートされる最小クライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の	ウィンドウズ
Header	roapi.h
Library	mincore.lib

こちらも参照ください

CoCreateInstance

IActivationFactory

IInspectable の

TrustLevel