IHostAssemblyStore::ProvideAssembly メソッド

  • [アーティクル]

IHostAssemblyManager::GetNonHostStoreAssemblies から返される ICLRAssemblyReferenceList によって参照されていないアセンブリへの参照を取得します。 共通言語ランタイム (CLR) では、一覧に表示されない各アセンブリに対して ProvideAssembly を呼び出します。

構文

HRESULT ProvideAssembly (  
    [in]  AssemblyBindInfo *pBindInfo,  
    [out] UINT64           *pAssemblyId,  
    [out] UINT64           *pHostContext,  
    [out] IStream          **ppStmAssemblyImage,  
    [out] IStream          **ppStmPDB  
);

パラメーター

pBindInfo
[入力] ホストで特定のバインド特性 (バージョン管理ポリシーの有無、およびバインド先のアセンブリなど) を決定するために使用される Assemblybindinfo インスタンスへのポインター。

pAssemblyId
[出力] この IStream の要求されたアセンブリの一意識別子へのポインター。

pHostContext
[出力] プラットフォーム呼び出しを必要とせずに、要求されたアセンブリの証拠を判断するために使用されるホスト固有のデータへのポインター。 pHostContext は、マネージド Assembly クラスの HostContext プロパティに対応します。

ppStmAssemblyImage
[出力] 読み込み対象のポータブル実行可能 (PE) イメージを格納している IStream のアドレスへのポインター、またはアセンブリが見つからなかった場合は null。

ppStmPDB
[出力] プログラム デバッグ (PDB) 情報を格納している IStream のアドレスへのポインター、または .pdb ファイルが見つからなかった場合は null。

戻り値

HRESULT 説明
S_OK ProvideAssembly が正常に返されました。
HOST_E_CLRNOTAVAILABLE CLR がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。
HOST_E_TIMEOUT 呼び出しがタイムアウトになりました。
HOST_E_NOT_OWNER 呼び出し元がロックを所有していません。
HOST_E_ABANDONED ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。
E_FAIL 原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。
COR_E_FILENOTFOUND (0x80070002) 要求されたアセンブリが見つかりませんでした。
E_NOT_SUFFICIENT_BUFFER pAssemblyId によって指定されたバッファー サイズは、ホストによって返される識別子を保持するのに十分な大きさではありません。

解説

pAssemblyId に対して返される ID 値は、ホストによって指定されます。 識別子は、プロセスの有効期間内で一意である必要があります。 CLR では、この値をストリームの一意識別子として使用します。 各値は、ProvideAssembly の他の呼び出しによって返される pAssemblyId の値と照合されます。 ホストから別の IStream と同じ pAssemblyId の値が返された場合は、CLR でそのストリームの内容が既にマップされているかどうかが確認されます。 その場合、ランタイムにより新しいイメージがマップされるのではなく、イメージの既存のコピーが読み込まれます。

必要条件

:「システム要件」を参照してください。

ヘッダー: MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして含まれます

.NET Framework のバージョン: 2.0 以降で使用可能

関連項目