CorBindToRuntimeEx 関数
更新 : 2007 年 11 月
アンマネージ ホストが共通言語ランタイム (CLR: Common Language Runtime) をプロセスに読み込むことを有効にします。CorBindToRuntime 関数と CorBindToRuntimeEx 関数は同じ操作を実行しますが、CorBindToRuntimeEx 関数を使用すると、CLR の動作を指定するようにフラグを設定できます。
CorBindToRuntimeEx を使用するシナリオの詳細については、「共通言語ランタイムのホスト」を参照してください。
この関数は、次の操作をホストに許可するパラメータを受け取ります。
読み込むランタイムのバージョンを指定します。
サーバー ビルドまたはワークステーション ビルドのどちらを読み込むのかを指定します。
同時実行ガベージ コレクションを実行するか、または非同時実行ガベージ コレクションを実行するかを制御します。
.gif "メモ") メモ : |
|---|
同時実行ガベージ コレクションは、Intel Itanium アーキテクチャ (以前の IA-64) を実装する 64 ビット システム上で WOW64 x86 エミュレータを実行しているアプリケーションではサポートされません。64 ビットの Windows システムで WOW64 を使用する方法の詳細については、「Running 32-bit Applications」を参照してください。 |
アセンブリをドメイン中立として読み込むかどうかを制御します。
CLR を起動する前に使用して、そのインスタンスを構成するための追加オプションを設定できる、ICorRuntimeHost へのインターフェイス ポインタを取得します。
HRESULT CorBindToRuntimeEx (
[in] LPWSTR pwszVersion,
[in] LPWSTR pwszBuildFlavor,
[in] DWORD startupFlags,
[in] REFCLSID rclsid,
[in] REFIID riid,
[out] LPVOID* 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 を指定すると、ランタイムの最新バージョンが読み込まれます。null を渡すと、ホストはどのバージョンのランタイムを読み込むかを制御できなくなります。状況によってはこのような方法が適切なこともありますが、読み込むバージョンを特定させておくことを強くお勧めします。
pwszBuildFlavor
[入力] CLR のサーバー ビルドまたはワークステーション ビルドのどちらを読み込むかを指定する文字列。有効値は svr または wks です。ワークステーション ビルドはシングルプロセッサ コンピュータでクライアント アプリケーションを実行するために最適化され、サーバー ビルドはガベージ コレクションでマルチ プロセッサを利用するために最適化されています。pwszBuildFlavor が null に設定されている場合は、ワークステーション ビルドが読み込まれます。シングルプロセッサ コンピュータで実行するときは、pwszBuildFlavor が svr に設定されている場合でも、常にワークステーション ビルドが読み込まれます。ただし、pwszBuildFlavor が svr に設定され、同時実行ガベージ コレクションが指定されている場合は (startupFlags パラメータを参照)、サーバー ビルドが読み込まれます。
startupFlags
[入力] STARTUP_FLAGS 列挙体の値の組み合わせ。これらのフラグは、同時実行ガベージ コレクション、ドメインに中立なコード、および pwszVersion パラメータの動作を制御します。どのフラグも設定されていない場合は、既定はシングル ドメインになります。有効な値は、次のとおりです。STARTUP_CONCURRENT_GC
STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN
STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN
STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST
STARTUP_LOADER_SAFEMODE
STARTUP_LEGACY_IMPERSONATION
STARTUP_LOADER_SETPREFERENCE
STARTUP_SERVER_GC
STARTUP_HOARD_GC_VM
STARTUP_SINGLE_VERSION_HOSTING_INTERFACE
STARTUP_LEGACY_IMPERSONATION
STARTUP_DISABLE_COMMITTHREADSTACK
STARTUP_ALWAYSFLOW_IMPERSONATION
これらのフラグの説明については、STARTUP_FLAGS 列挙体を参照してください。
rclsid
[入力] ICorRuntimeHost インターフェイスを実装しているコクラスの CLSID。サポートされている値は CLSID_CorRuntimeHost と CLSID_CLRRuntimeHost です。riid
[入力] 要求された rclsid のインターフェイスの IID。サポートされている値は IID_ICorRuntimeHost と IID_ICLRRuntimeHost です。ppv
[出力] 返された riid へのインターフェイス ポインタ。
解説
pwszVersion で指定したランタイムのバージョンが存在しない場合は、CorBindToRuntimeEx は CLR_E_SHIM_RUNTIMELOAD の HRESULT 値を返します。
Windows ID の実行コンテキストとフロー
CLR のバージョン 1 では、WindowsIdentity オブジェクトは、新しいスレッド、スレッド プール、タイマ コールバックなどの非同期ポイント間をフローしません。CLR のバージョン 2.0 では、ExecutionContext オブジェクトは現在実行しているスレッドに関する情報をラップして非同期ポイント間をフローしますが、アプリケーション ドメインの境界を越えることはありません。同様に、WindowsIdentity オブジェクトもすべての非同期ポイント間をフローします。したがって、現在スレッドに偽装がある場合は、その偽装もフローします。
2 つの方法のいずれかでフローを変更できます。
ExecutionContext 設定を変更し、スレッド単位ではフローしないようにします (SuppressFlow、SuppressFlow、および SuppressFlowWindowsIdentity の各メソッドを参照)。
処理の既定のモードを、現在のスレッドの ExecutionContext 設定がどの状態でも WindowsIdentity オブジェクトは非同期ポイント間をフローしない、バージョン 1 互換モードに変更します。既定のモードを変更する方法は、CLR を読み込むときにマネージ実行可能ファイルを使用するか、アンマネージ ホスト インターフェイスを使用するかに応じて異なります。
マネージ実行可能ファイルを使用する場合は、<legacyImpersonationPolicy> 要素の enabled 属性を true に設定する必要があります。
アンマネージ ホスト インターフェイスを使用する場合は、CorBindToRuntimeEx 関数を呼び出すときの startupFlags パラメータに STARTUP_LEGACY_IMPERSONATION フラグを設定します。
バージョン 1 互換モードは、その処理全体および処理のすべてのアプリケーション ドメインに適用されます。
必要条件
プラットフォーム : 「.NET Framework システム要件」を参照
ヘッダー : MSCorEE.idl
ライブラリ : MSCorEE.dll
.NET Framework のバージョン : 3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1、1.0