ICLRMetaHost::GetRuntime メソッドICLRMetaHost::GetRuntime Method

取得、 ICLRRuntimeInfo共通言語ランタイム (CLR) の特定のバージョンに対応するインターフェイス。Gets the ICLRRuntimeInfo interface that corresponds to a particular version of the common language runtime (CLR). このメソッドは、 CorBindToRuntimeExで使用される関数、 STARTUP_LOADER_SAFEMODEフラグ。This method supersedes the CorBindToRuntimeEx function used with the STARTUP_LOADER_SAFEMODE flag.

構文Syntax

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);  

パラメーターParameters

pwzVersion
[in]形式で、メタデータに格納されている .NET Framework のコンパイル バージョン"vA.B[.X]"。[in] The .NET Framework compilation version stored in the metadata, in the format "vA.B[.X]". AB、およびXはメジャー バージョン、マイナー バージョン、およびビルド番号に対応する 10 進数。A, B, and X are decimal numbers that correspond to the major version, the minor version, and the build number.

注意

C:\Windows\Microsoft.NET\Framework または C:\Windows\Microsoft.NET\Framework64 で表示される、このパラメーターは .NET Framework のバージョンのディレクトリ名に一致する必要があります。This parameter must match the directory name for the .NET Framework version, as it appears under C:\Windows\Microsoft.NET\Framework or C:\Windows\Microsoft.NET\Framework64.

例の値は、"v1.0.3705"、"v1.1.4322"、"v2.0.50727"および"v4.0 です。X"ここで、 Xインストールされているビルドの数によって異なります。Example values are "v1.0.3705", "v1.1.4322", "v2.0.50727", and "v4.0.X", where X depends on the build number installed. "V"プレフィックスが必要です。The "v" prefix is required.

riid
[in]必要なインターフェイスの識別子。[in] The identifier for the desired interface. 現時点では、このパラメーターの唯一の有効な値は、IID_ICLRRuntimeInfo です。Currently, the only valid value for this parameter is IID_ICLRRuntimeInfo.

ppRuntime
[out]ポインター、 ICLRRuntimeInfo要求されたランタイムに対応するインターフェイス。[out] A pointer to the ICLRRuntimeInfo interface that corresponds to the requested runtime.

戻り値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 pwzVersion または ppRuntime が null です。pwzVersion or ppRuntime is null.

RemarksRemarks

このメソッドとやり取り一貫して従来のインターフェイスなど、 ICorRuntimeHostインターフェイスおよび従来の関数など、非推奨CorBindTo*関数 (を参照してください非推奨の CLR ホスト関数 API をホストしている .NET Framework 2.0 で)。This method interacts consistently with legacy interfaces such as the ICorRuntimeHost interface and legacy functions such as the deprecated CorBindTo* functions (see Deprecated CLR Hosting Functions in the .NET Framework 2.0 hosting API). レガシ API で読み込まれたランタイムは、新しい API に表示されると、新しい API が読み込まれているランタイムがレガシ API に表示されます。That is, runtimes that are loaded with the legacy API are visible to the new API, and runtimes that are loaded with the new API are visible to the legacy API.

必要条件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