IHostAssemblyManager::GetNonHostStoreAssemblies 方法

获取一个接口指针，该指针指向表示宿主希望公共语言运行时 (CLR) 加载的程序集列表的 ICLRAssemblyReferenceList。

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

参数

ppReferenceList
[out] 一个指针，该指针指向包含若干程序集的引用列表的 ICLRAssemblyReferenceList 的地址，宿主希望 CLR 加载这些程序集。

HRESULT	说明
S_OK	GetNonHostStoreAssemblies 已成功返回。
HOST_E_CLRNOTAVAILABLE	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，然后探测应用程序基目录，以解析程序集引用。