Udostępnij za pośrednictwem

IHostAssemblyManager::GetNonHostStoreAssemblies — Metoda

  • Artykuł

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

Zobacz też