CorBindToRuntimeHost 関数

2008-09-17

更新 : 2007 年 11 月

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

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 の最新バージョンが読み込まれます。null を渡すと、ホストはどのバージョンのランタイムを読み込むかを制御できなくなります。状況によってはこのような方法が適切なこともありますが、読み込むバージョンを特定させておくことを強くお勧めします。

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
[入力] 検索するインターフェイスを実装するコクラスの CLSID。サポートされている値は CLSID_CorRuntimeHost と null です。
riid
[入力] 要求するインターフェイスの IID。ランタイムの初期リリースでサポートされている値は IID_ICorRuntimeHost と null です。
ppv
[出力] 読み込まれたランタイムのバージョンへのインターフェイスポインタ。