IHostAssemblyStore

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt Methoden bereit, mit denen ein Host unabhängig von der Common Language Runtime (CLR) Assemblys und Module laden kann.

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
    );
};

Methoden

Methode	Beschreibung
IHostAssemblyStore::ProvideAssembly-Methode	Ruft einen Verweis auf eine Assembly ab, auf die in der ICLRAssemblyReferenceList nicht verwiesen wird, die von einem Aufruf von IHostAssemblyManager::GetNonHostStoreAssemblies zurückgegeben wird.
IHostAssemblyStore::ProvideModule-Methode	Löst ein Modul in einer Assembly oder einer verknüpften (nicht eingebetteten) Ressourcendatei auf.

Hinweise

IHostAssemblyStore ermöglicht einem Host das effiziente Laden von Assemblys auf der Grundlage der Assemblyidentität. Der Host lädt Assemblys, indem er IStream-Instanzen zurückgibt, die direkt auf die Bytes verweisen.

Die CLR bestimmt, ob ein Host IHostAssemblyStore implementiert hat, indem sie bei der Initialisierung IHostAssemblyManager::GetNonHostAssemblyStores aufruft. Hierdurch kann der Host z. B. Bindungen an Benutzerassemblys steuern, während Bindungen an .NET Framework-Assemblys der Laufzeit überlassen bleiben.

Tipp

Durch das Bereitstellen einer Implementierung von IHostAssemblyStore gibt der Host seine Absicht an, alle Assemblys aufzulösen, auf die nicht durch die ICLRAssemblyReferenceList verwiesen wird, die von IHostAssemblyManager::GetNonHostStoreAssemblies zurückgegeben wurde.

Tipp

Im Gegensatz zum Native Image Generator (Ngen.exe)-Dienstprogramm ist es in .NET Framework, Version 2.0, nicht möglich, dass der Host das systemeigene Abbild einer Assembly lädt.