Método IHostAssemblyManager::GetNonHostStoreAssemblies

Artigo
08/25/2010

Obtém um ponteiro de interface para um ICLRAssemblyReferenceList que representa a lista de módulos (assemblies) que espera que o host a Common linguagem tempo de execução (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 para módulos (assemblies) que o host espera que o CLR para carregar.

Valor de retorno

HRESULT	Descrição
S_OK	GetNonHostStoreAssemblies retornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.
HOST_E_TIMEOUT	A telefonar expirou.
HOST_E_NOT_OWNER	O chamador não é proprietário do bloquear.
HOST_E_ABANDONED	Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem métodos retornam HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	Não havia memória suficiente disponível para criar a lista de referências para o solicitadaICLRAssemblyReferenceList.

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 se vincula a ele normalmente.
Se o assembly não aparecer na lista e o host tiver fornecido uma implementação de IHostAssemblyStore, o CLR chama IHostAssemblyStore::ProvideAssembly para permitir que o host fornecer o assembly para BIND a.
Caso contrário, o CLR não pode BIND ao assembly.

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