Método de IHostAssemblyManager::GetNonHostStoreAssemblies

Artigo
08/08/2011

Obtém um ponteiro de interface para um ICLRAssemblyReferenceList que representa a lista de assemblies que o host espera que o common language runtime (CLR) para carregar.

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

Parâmetros

ppReferenceList
[out] Um ponteiro para o endereço de um ICLRAssemblyReferenceList que contém uma lista de referências aos assemblies que o host espera o CLR para carregar.

Valor de retorno

HRESULT	Descrição
S_OK	GetNonHostStoreAssembliesretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória suficiente disponível para criar a lista de referências para a operação ICLRAssemblyReferenceList.

Comentários

O CLR resolve referências usando o conjunto de diretrizes a seguir:

Primeiro, ele consulta a lista de referências de assembly retornado por GetNonHostStoreAssemblies.
Se o assembly for exibido na lista, o CLR vincula-la normalmente.
Se o assembly não aparece na lista e o host forneceu uma implementação de IHostAssemblyStore, as chamadas CLR IHostAssemblyStore::ProvideAssembly para permitir que o host fornecer o assembly para vincular a.
Caso contrário, o CLR falhará vincular ao assembly.

Se o host define ppReferenceList como nulo, os testes CLR primeiro chama o cache global de assemblies, ProvideAssemblye em seguida, testes da base do aplicativo para resolver uma referência de assembly.

Observação

Na inicialização, o CLR chama GetNonHostStoreAssemblies somente uma vez.O método não é chamado novamente.