IHostAssemblyManager::GetNonHostStoreAssemblies 方法
取得 ICLRAssemblyReferenceList 的介面指標,其代表主機預期 Common Language Runtime (CLR) 載入的組件清單。
語法
HRESULT GetNonHostStoreAssemblies (
[out] ICLRAssemblyReferenceList **ppReferenceList
);
參數
ppReferenceList
[out] ICLRAssemblyReferenceList
的位址指標,包含主機預期 CLR 載入之組件的參考清單。
傳回值
HRESULT | 描述 |
---|---|
S_OK | GetNonHostStoreAssemblies 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | CLR 尚未載入處理序,或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
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
一次。 其不會再次呼叫該方法。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起可用