CorBindToRuntime 関数

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

アンマネージホストが共通言語ランタイム (CLR: Common Language Runtime) をプロセスに読み込むことを有効にします。

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

HRESULT CorBindToRuntime (
    [in]  LPCWSTR     pwszVersion, 
    [in]  LPCWSTR     pwszBuildFlavor, 
    [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 に対し、次に示すように flags パラメーターで値 STARTUP_LOADER_SAFEMODE を渡すことにより、ポリシー評価を省略し、pwszVersion で指定されたバージョンとまったく同じバージョンを読み込ませることができます。

呼び出し元が pwszVersion に null を指定すると、ランタイムの最新バージョンが読み込まれます。 null を渡すと、ホストはどのバージョンのランタイムを読み込むかを制御できなくなります。状況によってはこのような方法が適切なこともありますが、読み込むバージョンを特定させておくことを強くお勧めします。
pwszBuildFlavor
[入力] CLR のサーバービルドまたはワークステーションビルドのどちらを読み込むかを指定する文字列。有効値は svr または wks です。ワークステーションビルドはシングルプロセッサコンピューターでクライアントアプリケーションを実行するために最適化され、サーバービルドはガベージコレクションでマルチプロセッサを利用するために最適化されています。

pwszBuildFlavor が null に設定されている場合は、ワークステーションビルドが読み込まれます。シングルプロセッサコンピューターで実行するときは、pwszBuildFlavor が svr に設定されている場合でも、常にワークステーションビルドが読み込まれます。ただし、pwszBuildFlavor が svr に設定され、同時実行ガベージコレクションが指定されている場合は (flags パラメーターを参照)、サーバービルドが読み込まれます。
rclsid
[入力] ICorRuntimeHost インターフェイスまたは ICLRRuntimeHost インターフェイスを実装するコクラスの 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 を読み込むときにマネージ実行可能ファイルを使用するか、アンマネージホストインターフェイスを使用するかに応じて異なります。
1. マネージ実行可能ファイルを使用する場合は、<legacyImpersonationPolicy> 要素の enabled 属性を true に設定する必要があります。
2. アンマネージホストインターフェイスを使用する場合は、CorBindToRuntimeEx 関数を呼び出すときの flags パラメーターに STARTUP_LEGACY_IMPERSONATION フラグを設定します。
バージョン 1 互換モードは、その処理全体および処理のすべてのアプリケーションドメインに適用されます。