Metodo IHostAssemblyManager::GetNonHostStoreAssemblies

Articolo
08/11/2011

Ottiene un puntatore a interfaccia a ICLRAssemblyReferenceList che rappresenta l'elenco di assembly che dovranno essere caricati da Common Language Runtime (CLR).

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

Parametri

ppReferenceList
[out] Puntatore all'indirizzo di un'interfaccia ICLRAssemblyReferenceList che contiene l'elenco dei riferimenti ad assembly per i quali l'host prevede il caricamento da parte di CLR.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	GetNonHostStoreAssemblies ha restituito correttamente un valore.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non è il proprietario del blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Memoria disponibile insufficiente per creare l'elenco di riferimenti per ICLRAssemblyReferenceList richiesto.

Note

CLR risolve i riferimenti in base ai seguenti criteri:

Innanzitutto, consulta l'elenco dei riferimenti ad assembly restituito da GetNonHostStoreAssemblies.
Se l'assembly è riportato nell'elenco, CLR esegue l'associazione normalmente.
Se invece l'assembly non è riportato nell'elenco e l'host ha fornito un'implementazione diIHostAssemblyStore, CLR chiama IHostAssemblyStore::ProvideAssembly per consentire all'host di fornire l'assembly richiesto.
Se non si verifica alcuna delle due condizioni, l'associazione all'assembly non verrà eseguita.

Se l'host imposta ppReferenceList su null CLR esamina innanzitutto la Global Assembly Cache, quindi chiama ProvideAssembly e infine effettua la ricerca nella base dell'applicazione per risolvere il riferimento a un assembly.