ICLRRuntimeInfo::GetInterface メソッドICLRRuntimeInfo::GetInterface Method

現在のプロセスに CLR を読み込み、 ICLRRuntimeHostICLRStrongNameIMetaDataDispenserExなどのランタイムインターフェイスポインターを返します。Loads the CLR into the current process and returns runtime interface pointers, such as ICLRRuntimeHost, ICLRStrongName, and IMetaDataDispenserEx.

このメソッドは、 CorBindTo非推奨の CLR ホスト関数」セクションのすべての * 関数を置き換えます。This method supersedes all the CorBindTo* functions in the Deprecated CLR Hosting Functions section.

構文Syntax

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

パラメーターParameters

rclsid
からコクラスの CLSID インターフェイス。[in] The CLSID interface for the coclass.

riid
から要求されたインターフェイスの IID rclsid[in] The IID of the requested rclsid interface.

ppUnk
入出力クエリされたインターフェイスへのポインター。[out] A pointer to the queried interface.

戻り値Return Value

このメソッドは、次の特定の HRESULT と、メソッドの失敗を示す HRESULT エラーも返します。This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULTHRESULT 説明Description
S_OKS_OK メソッドは正常に完了しました。The method completed successfully.
E_POINTERE_POINTER ppUnk が null です。ppUnk is null.
E_OUTOFMEMORYE_OUTOFMEMORY 要求を処理するのに十分なメモリがありません。Not enough memory is available to handle the request.
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUNDCLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND 以前の CLR バージョン2のアクティブ化ポリシーに、別のランタイムが既にバインドされています。A different runtime was already bound to the legacy CLR version 2 activation policy.

解説Remarks

このメソッドを使用すると、CLR が読み込まれますが、初期化されません。This method causes the CLR to be loaded but not initialized.

次の表は、とでサポートされている組み合わせを示して rclsid riid います。The following table shows the supported combinations for rclsid and riid.

rclsid riid
CLSID_CorMetaDataDispenserCLSID_CorMetaDataDispenser IID_IMetaDataDispenser、IID_IMetaDataDispenserExIID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorMetaDataDispenserRuntimeCLSID_CorMetaDataDispenserRuntime IID_IMetaDataDispenser、IID_IMetaDataDispenserExIID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorRuntimeHostCLSID_CorRuntimeHost IID_ICorRuntimeHostIID_ICorRuntimeHost
CLSID_CLRRuntimeHostCLSID_CLRRuntimeHost IID_ICLRRuntimeHostIID_ICLRRuntimeHost
CLSID_TypeNameFactoryCLSID_TypeNameFactory IID_ITypeNameFactoryIID_ITypeNameFactory
CLSID_CLRDebuggingLegacyCLSID_CLRDebuggingLegacy IID_ICorDebugIID_ICorDebug
CLSID_CLRStrongNameCLSID_CLRStrongName IID_ICLRStrongNameIID_ICLRStrongName

要件Requirements

:システム要件」を参照してください。Platforms: See System Requirements.

ヘッダー: メタホスト .hHeader: MetaHost.h

ライブラリ: Mscoree.dll にリソースとして含まれていますLibrary: Included as a resource in MSCorEE.dll

.NET Framework のバージョン:4 以降で使用可能Available since 4.NET Framework Versions: 4 以降で使用可能Available since 4

関連項目See also