IHostAssemblyManager::GetNonHostStoreAssemblies — Metoda
Pobiera wskaźnik interfejsu do listy ICLRAssemblyReferenceList , która reprezentuje listę zestawów, które host oczekuje załadowania środowiska uruchomieniowego języka wspólnego (CLR).
Składnia
HRESULT GetNonHostStoreAssemblies (
[out] ICLRAssemblyReferenceList **ppReferenceList
);
Parametry
ppReferenceList
[out] Wskaźnik do adresu ICLRAssemblyReferenceList , który zawiera listę odwołań do zestawów, które host oczekuje załadowania clR.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | GetNonHostStoreAssemblies zwrócono pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Za mało pamięci było dostępne, aby utworzyć listę odwołań dla żądanego ICLRAssemblyReferenceListobiektu . |
Uwagi
ClR rozpoznaje odwołania przy użyciu następującego zestawu wytycznych:
Najpierw należy zapoznać się z listą odwołań do zestawu zwróconych przez
GetNonHostStoreAssemblieselement .Jeśli zestaw pojawi się na liście, clR wiąże się z nim normalnie.
Jeśli zestaw nie jest wyświetlany na liście i host dostarczył implementację IHostAssemblyStore, clR wywołuje IHostAssemblyStore::P rovideAssembly, aby umożliwić hostowi dostarczenie zestawu do powiązania.
W przeciwnym razie nie można powiązać środowiska CLR z zestawem.
Jeśli host ustawi ppReferenceList wartość null, usługa CLR najpierw sonduje globalną pamięć podręczną zestawów, wywołuje ProvideAssemblymetodę , a następnie sonduje bazę aplikacji w celu rozwiązania odwołania do zestawu.
Uwaga
Po zainicjowaniu clR wywołuje GetNonHostStoreAssemblies tylko raz. Metoda nie jest ponownie wywoływana.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
.NET Framework wersje: dostępne od wersji 2.0
