Partilhar via

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

Ver também

  • Last updated on