Methode IHostAssemblyManager::GetNonHostStoreAssemblies
Hiermee haalt u een interfaceaanwijzer op naar een ICLRAssemblyReferenceList die de lijst met assembly's vertegenwoordigt waarvan de host verwacht dat de Common Language Runtime (CLR) wordt geladen.
Syntaxis
HRESULT GetNonHostStoreAssemblies (
[out] ICLRAssemblyReferenceList **ppReferenceList
);
Parameters
ppReferenceList
[uit] Een verwijzing naar het adres van een ICLRAssemblyReferenceList
met een lijst met verwijzingen naar assembly's waarvan de host verwacht dat de CLR wordt geladen.
Retourwaarde
HRESULT | Beschrijving |
---|---|
S_OK | GetNonHostStoreAssemblies is geretourneerd. |
HOST_E_CLRNOTAVAILABLE | De CLR is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt. |
HOST_E_TIMEOUT | Er is een time-out opgetreden voor het gesprek. |
HOST_E_NOT_OWNER | De beller is niet de eigenaar van het vergrendelingsslot. |
HOST_E_ABANDONED | Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte. |
E_FAIL | Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE. |
E_OUTOFMEMORY | Er was onvoldoende geheugen beschikbaar om de lijst met verwijzingen voor de aangevraagde ICLRAssemblyReferenceList te maken. |
Opmerkingen
De CLR lost verwijzingen op met behulp van de volgende set richtlijnen:
Eerst raadpleegt zij de lijst van assembly-verwijzingen die door
GetNonHostStoreAssemblies
worden geretourneerd.Als de assembly in de lijst wordt weergegeven, wordt de CLR er normaal aan gebonden.
Als de assembly niet in de lijst wordt weergegeven en de host een implementatie van IHostAssemblyStore heeft opgegeven, roept de CLR IHostAssemblyStore::P rovideAssembly aan, zodat de host de assembly kan leveren om aan te binden.
Anders kan de CLR niet worden gebonden aan de assembly.
Als de host op null wordt ingesteld ppReferenceList
, test de CLR eerst de globale assemblycache, roept ProvideAssembly
aan en test vervolgens de toepassingsbasis om een assembly-verwijzing op te lossen.
Notitie
Bij de initialisatie roept GetNonHostStoreAssemblies
de CLR slechts één keer aan. De methode wordt niet opnieuw aangeroepen.
Vereisten
Platforms: Zie Systeemvereisten.
Header: MSCorEE.h
Bibliotheek: Opgenomen als een resource in MSCorEE.dll
.NET Framework versies: beschikbaar sinds 2.0