更新 : 2007 年 11 月
アセンブリ内または、リンクされているリソース ファイル (埋め込まれているリソース ファイルではない) 内のモジュールを解決します。
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.idl
ライブラリ : MSCorEE.dll にリソースとして格納されていること
.NET Framework のバージョン : 3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0