次の方法で共有


IHostAssemblyStore::ProvideModule メソッド

アセンブリ内または、リンクされているリソース ファイル (埋め込まれているリソース ファイルではない) 内のモジュールを解決します。

HRESULT ProvideModule (
    [in]  ModuleBindInfo *pBindInfo,
    [out] DWORD          *pdwModuleId,
    [out] IStream        **ppStmModuleImage,
    [out] IStream        **ppStmPDB
);

パラメーター

  • pBindInfo
    [入力] 要求するモジュールの AppDomain、アセンブリ、およびモジュール名を示す ModuleBindInfo インスタンスへのポインター。

  • pdwModuleId
    [出力] 読み込まれたモジュールが含まれている IStream の一意の ID へのポインター。

  • ppStmModuleImage
    [出力] 読み込まれているポータブル実行可能 (PE: Portable Executable) イメージを含む IStream オブジェクトのアドレスへのポインター。モジュールが見つからなかった場合は null。

  • ppStmPDB
    [出力] 要求したモジュールのプログラム デバッグ (PDB: Program Debug) 情報を含む IStream オブジェクトのアドレスへのポインター。.pdb ファイルが見つからなかった場合は null。

戻り値

HRESULT

説明

S_OK

ProvideModule が正常に終了しました。

HOST_E_CLRNOTAVAILABLE

共通言語ランタイム (CLR: Common Language Runtime) がプロセスに読み込まれていません。または CLR がマネージ コードを実行できない状態か、呼び出しを正常に処理できない状態にあります。

HOST_E_TIMEOUT

呼び出しがタイムアウトしました。

HOST_E_NOT_OWNER

呼び出し元がロックを所有していません。

HOST_E_ABANDONED

ブロックされたスレッドまたはファイバーが待機しているイベントがキャンセルされました。

E_FAIL

未知の重大エラーが発生しました。 メソッドから E_FAIL が返される場合、プロセス内で CLR を使用することはできません。 ホスト メソッドへの後続の呼び出しで、HOST_E_CLRNOTAVAILABLE が返されます。

ERROR_FILE_NOT_FOUND

要求したアセンブリ、またはリンクされているリソースが見つかりませんでした。

ERROR_INSUFFICIENT_BUFFER

pdwModuleId の大きさが足りないため、ホストが返す ID を含めることができません。

解説

pdwModuleId に返される ID 値は、ホストによって指定されます。 ID は、プロセスの有効期間中は一意である必要があります。 CLR は、この値を、関連付けられているストリームの一意の ID として使用します。 それぞれの値は、ProvideAssembly 呼び出しによって返された pAssemblyId の値、および他の ProvideModule 呼び出しによって返された pdwModuleId の値と比較して確認されます。 ホストが他の IStream と同じ ID 値を返した場合、CLR は、そのストリームの内容が既に割り当てられているかどうかを確認します。 割り当てられている場合、CLR は新しいイメージを割り当てる代わりに、既存のイメージのコピーを読み込みます。 このため、ID が ProvideAssembly から返されるアセンブリ ID と重複しないことも必要です。

必要条件

プラットフォーム: 「.NET Framework システム要件」を参照

ヘッダー : MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして格納されていること

.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

参照

参照

ICLRAssemblyReferenceList インターフェイス

IHostAssemblyManager インターフェイス

IHostAssemblyStore インターフェイス