IHostAssemblyStore

Artículo
10/07/2008

Actualización: noviembre 2007

Proporciona métodos que permiten al host cargar ensamblados y módulos independientemente de Common Language Runtime (CLR).

interface IHostAssemblyStore: IUnknown {
    HRESULT ProvideAssembly (
        [in]  AssemblyBindInfo *pBindInfo,
        [out] UINT64           *pAssemblyId,
        [out] UINT64           *pHostContext,
        [out] IStream          **ppStmAssemblyImage,
        [out] IStream          **ppStmPDB
    );
    HRESULT ProvideModule (
        [in]  ModuleBindInfo   *pBindInfo,
        [out] DWORD            *pdwModuleId,
        [out] IStream          **ppStmModuleImage,
        [out] IStream          **ppStmPDB
    );
};

Métodos

Método	Descripción
IHostAssemblyStore::ProvideAssembly (Método)	Obtiene una referencia a un ensamblado al que no hace referencia la interfaz ICLRAssemblyReferenceList devuelta por IHostAssemblyManager::GetNonHostStoreAssemblies.
IHostAssemblyStore::ProvideModule (Método)	Resuelve un módulo de un ensamblado, o un archivo de recursos vinculado (no incrustado).

Comentarios

IHostAssemblyStore permite al host cargar los ensamblados eficazmente basándose en la identidad del ensamblado. El host carga los ensamblados devolviendo instancias de IStream que señalan directamente a los bytes.

CLR determina si un host ha implementado IHostAssemblyStore llamando a IHostAssemblyManager::GetNonHostAssemblyStores tras la inicialización. Por ejemplo, esto permite al host controlar el enlace a los ensamblados de usuario, aunque se basa en el motor en tiempo de ejecución para establecer enlaces con los ensamblados de .NET Framework.

Nota

Proporcionando una implementación de IHostAssemblyStore, el host especifica su intento de resolver todos los ensamblados a los que no hace referencia el ICLRAssemblyReferenceList devuelto desde IHostAssemblyManager::GetNonHostStoreAssemblies.

Nota

La versión 2.0 de .NET Framework no proporciona al host ningún medio para cargar la imagen nativa de un ensamblado como el que proporciona la utilidad Native Image Generator (Ngen.exe).