ICLRRuntimeInfo::GetInterface メソッド

  • [アーティクル]

更新 : 2010 年 10 月

CLR を現在のプロセスに読み込み、ICLRRuntimeHost、ICLRStrongName、IMetaDataDispenser などのランタイム インターフェイス ポインターを返します。

このメソッドは、「.NET Framework 1.1 および 2.0 のホスト グローバル静的関数」に示すすべての CorBindTo* 関数よりも優先されます。

HRESULT GetInterface(
[in]  REFCLSID rclsid,
[in]  REFIID   riid,
[out, iid_is(riid), retval] LPVOID *ppUnk);

パラメーター

  • rclsid
    [入力] コクラスの CLSID インターフェイス。

  • riid
    [入力] 要求された rclsid インターフェイスの IID。

  • ppUnk
    [出力] 照会されたインターフェイスへのポインター。

戻り値

このメソッドは、次の特定の HRESULT と、メソッドの失敗を示す HRESULT エラーも返します。

HRESULT

説明

S_OK

メソッドは正常に終了しました。

E_POINTER

ppUnk が null です。

E_OUTOFMEMORY

メモリ不足のため、要求を処理できません。

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

別のランタイムが CLR Version 2 の従来の起動ポリシーに既に関連付けられています。

解説

このメソッドによって CLR は、読み込まれますが、初期化されません。

次の表は、rclsid コマンドおよび riid コマンドでサポートされている組み合わせを示しています。

rclsid

riid

CLSID_CorMetaDataDispenser

IID_IMetaDataDispenser、IID_IMetaDataDispenserEx

CLSID_CorMetaDataDispenserRuntime

IID_IMetaDataDispenser、IID_IMetaDataDispenserEx

CLSID_CorRuntimeHost

IID_ICorRuntimeHost

CLSID_CLRRuntimeHost

IID_ICLRRuntimeHost

CLSID_TypeNameFactory

IID_ITypeNameFactory

CLSID_CLRStrongName

IID_ICLRStrongName

必要条件

プラットフォーム: 「.NET Framework システム要件」を参照

ヘッダー: MetaHost.h

ライブラリ: MSCorEE.dll にリソースとして格納されていること

.NET Framework のバージョン: 4

参照

参照

ICLRRuntimeInfo インターフェイス

その他の技術情報

ホスト インターフェイス

ホスト (アンマネージ API リファレンス)

履歴の変更

日付

履歴

理由

2010 年 10 月

CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND をリターン コードに追加。

コンテンツ バグ修正

2010 年 9 月

いくつかの riid エントリを修正。

カスタマー フィードバック

2010 年 6 月

CLSID_CLRRuntimeHost と組み合わせて使用できる riid を修正。

コンテンツ バグ修正