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