Интерфейс IHostAssemblyStore

Статья
11/16/2008

Обновлен: Ноябрь 2007

Предоставляет методы, позволяющие основному приложению загружать сборки и модули независимо от среды 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
    );
};

Методы

Метод	Описание
Метод IHostAssemblyStore::ProvideAssembly	Получает ссылку на сборку, на которую не ссылается интерфейс ICLRAssemblyReferenceList возвращенный в результате вызова интерфейса IHostAssemblyManager::GetNonHostStoreAssemblies.
Метод IHostAssemblyStore::ProvideModule	Разрешает модуль в сборке или связанном (не внедренном) файле ресурсов.

Заметки

Интерфейс IHostAssemblyStore предоставляет основному приложению возможность эффективно загружать сборки на основе их идентификаторов. Основное приложение загружает сборки, возвращая экземпляры IStream, которые указываю непосредственно на байты.

Среда CLR определяет, реализовало ли основное приложение интерфейс IHostAssemblyStore, вызвав метод IHostAssemblyManager::GetNonHostAssemblyStores при инициализации. Это, например, позволяет основному приложению управлять привязкой к пользовательским сборкам, однако для привязки к сборкам .NET Framework нужна среда выполнения.

Примечание.
В усовершенствованной реализации интерфейса IHostAssemblyStore основное приложение сообщает о своем намерении разрешить все сборки, на которые не ссылается интерфейс ICLRAssemblyReferenceList, возвращенный методом IHostAssemblyManager::GetNonHostStoreAssemblies.

В усовершенствованной реализации интерфейса IHostAssemblyStore основное приложение сообщает о своем намерении разрешить все сборки, на которые не ссылается интерфейс ICLRAssemblyReferenceList, возвращенный методом IHostAssemblyManager::GetNonHostStoreAssemblies.

Примечание.
Платформа .NET Framework версии 2.0 не предоставляет основному приложению возможность загружать образ сборки в машинном коде, предоставленный генератором образов в машинном коде (Ngen.exe).