IHostAssemblyManager::GetNonHostStoreAssemblies, méthode

Article
08/10/2011

Obtient un pointeur d'interface vers un ICLRAssemblyReferenceList qui représente la liste d'assemblys. L'hôte s'attend à ce que le Common Language Runtime (CLR) charge cette liste.

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

Paramètres

ppReferenceList
[out] Pointeur vers l'adresse d'un ICLRAssemblyReferenceList qui contient une liste de références aux assemblys. L'hôte s'attend à ce que le CLR charge cette liste.

Valeur de retour

HRESULT	Description
S_OK	GetNonHostStoreAssemblies a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY	La mémoire disponible était insuffisante pour créer la liste de références pour l'ICLRAssemblyReferenceList demandé.

Notes

Le CLR résout les références en suivant les indications ci-dessous :

En premier lieu, il consulte la liste de références d'assembly retournée par GetNonHostStoreAssemblies.
Si l'assembly figure dans la liste, le CLR se lie normalement à lui.
Si l'assembly ne figure pas dans la liste et si l'hôte a fourni une implémentation d'IHostAssemblyStore, le CLR appelle IHostAssemblyStore::ProvideAssembly pour permettre à l'hôte de fournir l'assembly auquel se lier.
Sinon, le CLR ne parvient pas à se lier à l'assembly.

Si l'hôte affecte null à ppReferenceList, le CLR commence alors par sonder le Global Assembly Cache, puis appelle ProvideAssembly et sonde la base de l'application pour résoudre une référence d'assembly.