CorBindToRuntimeHost 関数

[アーティクル]
08/09/2011

ホストが、指定したバージョンの共通言語ランタイム (CLR: Common Language Runtime) をプロセスに読み込むことができるようにします。

この関数は、.NET Framework Version 4 では推奨されていません。

HRESULT CorBindToRuntimeHost (
    [in] LPCWSTR       pwszVersion, 
    [in] LPCWSTR       pwszBuildFlavor, 
    [in] LPCWSTR       pwszHostConfigFile, 
    [in] VOID*         pReserved, 
    [in] DWORD         startupFlags, 
    [in] REFCLSID      rclsid, 
    [in] REFIID        riid, 
    [out] LPVOID FAR  *ppv
);

パラメーター

pwszVersion
[入力] 読み込む CLR のバージョンを示す文字列。

.NET Framework のバージョン番号は、major.minor.build.revision のように、ピリオドで区切られた 4 つの部分で構成されています。 pwszVersion として渡される文字列は、文字 "v" で始まり、バージョン番号の最初の 3 つの部分がその後に続く必要があります (たとえば "v1.0.1529")。

いくつかのバージョンの CLR は、以前のバージョンの CLR との互換性を指定するポリシーステートメントと共にインストールされています。既定では、スタートアップ shim により、ポリシーステートメントに対して pwszVersion が評価され、要求されたバージョンと互換性がある最新バージョンのランタイムが読み込まれます。ホストは shim に対し、startupFlags パラメーターで値 STARTUP_LOADER_SAFEMODE を渡すことにより、ポリシー評価を省略し、pwszVersion で指定されたバージョンとまったく同じバージョンを読み込ませることができます。

pwszVersion が null, の場合、メソッドはどのバージョンの CLR も読み込みません。代わりに、ランタイムの読み込みに失敗したことを示す CLR_E_SHIM_RUNTIMELOAD が返されます。

pwszBuildFlavor
[入力] CLR のサーバービルドまたはワークステーションビルドのどちらを読み込むかを指定する文字列。有効値は svr または wks です。ワークステーションビルドはシングルプロセッサコンピューターでクライアントアプリケーションを実行するために最適化され、サーバービルドはガベージコレクションでマルチプロセッサを利用するために最適化されています。

pwszBuildFlavor が null に設定されている場合は、ワークステーションビルドが読み込まれます。シングルプロセッサコンピューターで実行するときは、pwszBuildFlavor が svr に設定されている場合でも、常にワークステーションビルドが読み込まれます。ただし、pwszBuildFlavor が svr に設定され、同時実行ガベージコレクションが指定されている場合は (startupFlags パラメーターを参照)、サーバービルドが読み込まれます。

メモ
同時実行ガベージコレクションは、Intel Itanium アーキテクチャ (以前の IA-64) を実装する 64 ビットシステム上で WOW64 x86 エミュレーターを実行しているアプリケーションではサポートされません。64 ビットの Windows システムで WOW64 を使用する方法の詳細については、「Running 32-bit Applications」を参照してください。

同時実行ガベージコレクションは、Intel Itanium アーキテクチャ (以前の IA-64) を実装する 64 ビットシステム上で WOW64 x86 エミュレーターを実行しているアプリケーションではサポートされません。64 ビットの Windows システムで WOW64 を使用する方法の詳細については、「Running 32-bit Applications」を参照してください。

pwszHostConfigFile
[入力] 読み込む CLR のバージョンを指定するホスト構成ファイルの名前。ファイル名に絶対パスが含まれていない場合、ファイルは呼び出しを行った実行可能ファイルと同じディレクトリにあるものと見なされます。
pReserved
[入力] 将来の機能拡張に備えて予約されています。
startupFlags
[入力] 同時実行ガベージコレクション、ドメインに中立なコード、および pwszVersion パラメーターの動作を制御するフラグのセット。どのフラグも設定されていない場合は、既定はシングルドメインになります。次の値がサポートされています。
- STARTUP_CONCURRENT_GC : 同時実行ガベージコレクションを使用することを指定します。呼び出し元がサーバービルドを要求し、シングルプロセッサコンピューター上で同時実行ガベージコレクションを指定した場合は、代わりにワークステーションビルドと非同時実行ガベージコレクションが使用されます。
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN : アセンブリをドメイン中立として読み込まないことを指定します。
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN : すべてのアセンブリをドメイン中立として読み込むことを指定します。
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST : すべての厳密な名前付きのアセンブリをドメイン中立として読み込むことを指定します。
- STARTUP_LOADER_SAFEMODE : pwszVersion で渡されたものと同じバージョンの CLR を読み込むように指定します。シムは、互換性のある最新バージョンを決めるためのポリシーの評価を実行しません。
rclsid
[入力] ICorRuntimeHost インターフェイスまたは ICLRRuntimeHost インターフェイスを実装するコクラスの CLSID。サポートされている値は CLSID_CorRuntimeHost と CLSID_CLRRuntimeHost です。
riid
[入力] 要求するインターフェイスの IID。サポートされている値は IID_ICorRuntimeHost と IID_ICLRRuntimeHost です。
ppv
[出力] 読み込まれたランタイムのバージョンへのインターフェイスポインター。