IHostAssemblyManager::GetNonHostStoreAssemblies – metoda
Získá ukazatel rozhraní ICLRAssemblyReferenceList , který představuje seznam sestavení, které hostitel očekává common language runtime (CLR) načtení.
Syntaxe
HRESULT GetNonHostStoreAssemblies (
[out] ICLRAssemblyReferenceList **ppReferenceList
);
Parametry
ppReferenceList
[out] Ukazatel na adresu objektu ICLRAssemblyReferenceList
, který obsahuje seznam odkazů na sestavení, která hostitel očekává načtení modulu CLR.
Návratová hodnota
HRESULT | Description |
---|---|
S_OK | GetNonHostStoreAssemblies úspěšně vráceno. |
HOST_E_CLRNOTAVAILABLE | ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání. |
HOST_E_TIMEOUT | Časový limit hovoru vypršel. |
HOST_E_NOT_OWNER | Volající zámek nevlastní. |
HOST_E_ABANDONED | Událost byla zrušena, zatímco na ni čekalo blokované vlákno nebo vlákno. |
E_FAIL | Došlo k neznámému závažnému selhání. Když metoda vrátí E_FAIL, clr již není možné v rámci procesu použít. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | K vytvoření seznamu odkazů pro požadovaný ICLRAssemblyReferenceList objekt nebyl k dispozici dostatek paměti. |
Poznámky
ClR překládá odkazy pomocí následující sady pokynů:
Nejprve nahlédnou do seznamu odkazů na sestavení vrácených nástrojem
GetNonHostStoreAssemblies
.Pokud se sestavení zobrazí v seznamu, CLR s ním obvykle vytvoří vazbu.
Pokud se sestavení nezobrazí v seznamu a hostitel poskytl implementaci IHostAssemblyStore, CLR volá IHostAssemblyStore::P rovideAssembly , aby hostitel mohl poskytnout sestavení pro vytvoření vazby.
V opačném případě se modulu CLR nepodaří vytvořit vazbu na sestavení.
Pokud hostitel nastaví ppReferenceList
hodnotu null, CLR nejprve testuje globální mezipaměť sestavení (GM) ProvideAssembly
a pak testuje základ aplikace za účelem překladu odkazu na sestavení.
Poznámka
Při inicializaci volá CLR GetNonHostStoreAssemblies
pouze jednou. Metoda není volána znovu.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnutý jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0