IHostAssemblyManager::GetNonHostStoreAssemblies-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Ruft einen Schnittstellenzeiger auf eine ICLRAssemblyReferenceList ab, die die Liste der Assemblys darstellt; von der der Host erwartet, dass sie von der Common Language Runtime (CLR) geladen wird.

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

Parameter

ppReferenceList
[out] Ein Zeiger auf die Adresse einer ICLRAssemblyReferenceList, die eine Liste von Verweisen auf Assemblys enthält, von der der Host erwartet, dass sie von der CLR geladen wird.

Rückgabewert

HRESULT	Beschreibung
S_OK	GetNonHostStoreAssemblies wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Das Zeitlimit für den Aufruf wurde überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um die Liste der Verweise für die angeforderte ICLRAssemblyReferenceList zu erstellen.

Hinweise

Die CLR löst Verweise mithilfe der folgenden Richtlinien auf:

Zuerst schlägt sie in der Liste der Assemblyverweise nach, die von GetNonHostStoreAssemblies zurückgegeben wird.
Wenn die Assembly in der Liste aufgeführt ist, wird die CLR auf die übliche Weise gebunden.
Wenn die Assembly nicht in der Liste aufgeführt ist und der Host eine Implementierung von IHostAssemblyStore bereitgestellt hat, ruft die CLR IHostAssemblyStore::ProvideAssembly auf, um dem Host die Bereitstellung der zu bindenden Assembly zu ermöglichen.
Andernfalls schlägt das Binden an die Assembly durch die CLR fehl.

Wenn der Host ppReferenceList auf NULL festlegt, durchsucht die CLR zuerst den globalen Assemblycache, ruft dann ProvideAssembly auf und durchsucht danach die Anwendungsbasis, um einen Assemblyverweis aufzulösen.

Tipp

Bei der Initialisierung ruft die CLR GetNonHostStoreAssemblies nur einmal auf. Die Methode wird nicht erneut aufgerufen.