Delen via

Methode IHostAssemblyStore::P rovideAssembly

  • Artikel

Hiermee haalt u een verwijzing op naar een assembly waarnaar niet wordt verwezen door de ICLRAssemblyReferenceList die wordt geretourneerd door IHostAssemblyManager::GetNonHostStoreAssemblies. De Common Language Runtime (CLR) roept ProvideAssembly aan voor elke assembly die niet in de lijst wordt weergegeven.

Syntaxis

HRESULT ProvideAssembly (  
    [in]  AssemblyBindInfo *pBindInfo,  
    [out] UINT64           *pAssemblyId,  
    [out] UINT64           *pHostContext,  
    [out] IStream          **ppStmAssemblyImage,  
    [out] IStream          **ppStmPDB  
);

Parameters

pBindInfo
[in] Een verwijzing naar een AssemblyBindInfo-exemplaar dat de host gebruikt om bepaalde bindingskenmerken te bepalen, waaronder de aanwezigheid of afwezigheid van een versiebeleid en met welke assembly verbinding moet worden gemaakt.

pAssemblyId
[uit] Een verwijzing naar een unieke id voor de aangevraagde assembly voor deze IStream.

pHostContext
[uit] Een verwijzing naar hostspecifieke gegevens die worden gebruikt om het bewijs van de aangevraagde assembly te bepalen zonder dat er een platform-aanroep nodig is. pHostContext komt overeen met de HostContext eigenschap van de beheerde Assembly klasse.

ppStmAssemblyImage
[uit] Een aanwijzer naar het adres van een IStream die de draagbare uitvoerbare installatiekopieën (PE) bevat die moeten worden geladen, of null als de assembly niet kan worden gevonden.

ppStmPDB
[uit] Een aanwijzer naar het adres van een IStream die de PDB-gegevens (program debug) bevat, of null als het .pdb-bestand niet kan worden gevonden.

Retourwaarde

HRESULT Beschrijving
S_OK ProvideAssembly 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.
COR_E_FILENOTFOUND (0x80070002) De aangevraagde assembly kan niet worden gevonden.
E_NOT_SUFFICIENT_BUFFER De buffergrootte die is opgegeven door pAssemblyId is niet groot genoeg om de id te bevatten die de host wil retourneren.

Opmerkingen

De id-waarde die wordt geretourneerd voor pAssemblyId wordt opgegeven door de host. Id's moeten uniek zijn binnen de levensduur van een proces. De CLR gebruikt deze waarde als een unieke id voor de stream. Elke waarde wordt gecontroleerd op basis van de waarden die pAssemblyId worden geretourneerd door andere aanroepen naar ProvideAssembly. Als de host dezelfde pAssemblyId waarde retourneert voor een andere IStream, controleert de CLR of de inhoud van die stream al is toegewezen. Als dat het zo is, laadt de runtime de bestaande kopie van de installatiekopie in plaats van een nieuwe toe te voegen.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook