IHostAssemblyManager::GetNonHostStoreAssemblies メソッド

共通言語ランタイム (CLR) に読み込まれることがホストで想定されているアセンブリの一覧を表す 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 を呼び出し、それからアプリケーションベースを調べてアセンブリ参照を解決します。

Note

初期化時、CLR によって GetNonHostStoreAssemblies が 1 回だけ呼び出されます。このメソッドがもう一度呼び出されることはありません。

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

ヘッダー: MSCorEE.h

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

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