IHostAssemblyManager::GetNonHostStoreAssemblies メソッド

ホストが共通言語ランタイム (CLR: Common Language Runtime) に対して読み込みを要求するアセンブリの一覧を表す ICLRAssemblyReferenceList へのインターフェイスポインターを取得します。

HRESULT GetNonHostStoreAssemblies (
    [out] ICLRAssemblyReferenceList **ppReferenceList
);

パラメーター

ppReferenceList
[出力] ホストが CLR に対して読み込みを要求するアセンブリへの参照の一覧を含む ICLRAssemblyReferenceList のアドレスへのポインター。

HRESULT	説明
S_OK	GetNonHostStoreAssemblies が正常に終了しました。
HOST_E_CLRNOTAVAILABLE	CLR がプロセスに読み込まれていません。または、CLR がマネージコードを実行できない状態か、呼び出しを正常に処理できない状態にあります。
HOST_E_TIMEOUT	呼び出しがタイムアウトしました。
HOST_E_NOT_OWNER	呼び出し元がロックを所有していません。
HOST_E_ABANDONED	ブロックされたスレッドまたはファイバーが待機しているイベントがキャンセルされました。
E_FAIL	未知の重大エラーが発生しました。メソッドから E_FAIL が返される場合、プロセス内で CLR を使用することはできません。ホストメソッドへの後続の呼び出しは、HOST_E_CLRNOTAVAILABLE を返します。
E_OUTOFMEMORY	メモリ不足のため、要求された ICLRAssemblyReferenceList の参照の一覧を作成できませんでした。

CLR は次のガイドラインに従って参照を解決します。

最初に、GetNonHostStoreAssemblies から返されたアセンブリ参照の一覧を参照します。
この一覧にアセンブリが表示されている場合、CLR はそれに通常どおりにバインドします。
この一覧にアセンブリが表示されていない場合で、ホストに IHostAssemblyStore が実装されている場合、CLR は IHostAssemblyStore::ProvideAssembly を呼び出し、ホストがこのアセンブリを指定してバインドできるようにします。
それ以外の場合は、CLR はアセンブリのバインドに失敗します。

ホストが ppReferenceList を null に設定すると、CLR は最初にグローバルアセンブリキャッシュを検索し、ProvideAssembly を呼び出してから、アプリケーションベースを検索してアセンブリ参照を解決します。

メモ
初期化時に、CLR は GetNonHostStoreAssemblies を一度だけ呼び出します。このメソッドは再度呼び出されることはありません。