Método IHostAssemblyManager::GetNonHostStoreAssemblies
Obtém um ponteiro de interface para um ICLRAssemblyReferenceList que representa a lista de assemblagens que o anfitrião espera que o runtime de idioma comum (CLR) carregue.
Sintaxe
HRESULT GetNonHostStoreAssemblies (
[out] ICLRAssemblyReferenceList **ppReferenceList
);
Parâmetros
ppReferenceList
[fora] Um ponteiro para o endereço de um ICLRAssemblyReferenceList que contém uma lista de referências a assemblagens que o anfitrião espera que o CLR carregue.
Devolver Valor
| HRESULT | Description |
|---|---|
| S_OK | GetNonHostStoreAssemblies devolvido com êxito. |
| HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
| HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
| HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
| HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo. |
| E_FAIL | Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Não havia memória suficiente disponível para criar a lista de referências para o pedido ICLRAssemblyReferenceList. |
Observações
O CLR resolve as referências com o seguinte conjunto de diretrizes:
Primeiro, consulta a lista de referências de assemblagem devolvidas por
GetNonHostStoreAssemblies.Se a assemblagem aparecer na lista, o CLR vincula-se normalmente à mesma.
Se a assemblagem não aparecer na lista e o anfitrião tiver fornecido uma implementação do IHostAssemblyStore, o CLR chama IHostAssemblyStore::P rovideAssembly para permitir que o anfitrião forneça a assemblagem à qual se vincular.
Caso contrário, o CLR não se vincula à assemblagem.
Se o anfitrião definir ppReferenceList como nulo, o CLR primeiro sonda a cache de assemblagem global, chama ProvideAssemblye, em seguida, sonda a base de aplicações para resolver uma referência de assemblagem.
Nota
Após a inicialização, o CLR chama GetNonHostStoreAssemblies apenas uma vez. O método não é chamado novamente.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0
