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

  • 共同作成者
    • Ron Petrusha
    • olprod

現在のプロセスに CLR をロードし、ランタイム、インターフェイス ポインターをなど返しますICLRRuntimeHost、 ICLRStrongName、およびIMetaDataDispenserExします。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
[in]コクラスの CLSID のインターフェイスです。[in] The CLSID interface for the coclass.

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

ppUnk
[out]照会されたインターフェイスへのポインター。[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.

RemarksRemarks

このメソッドにより、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.

ヘッダー: MetaHost.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