Udostępnij przez

ICLRMetaHost::GetRuntime — Metoda

Pobiera interfejs ICLRRuntimeInfo odpowiadający określonej wersji środowiska uruchomieniowego języka wspólnego (CLR). Ta metoda zastępuje funkcję CorBindToRuntimeEx używaną z flagą STARTUP_LOADER_SAFEMODE .

Składnia

HRESULT GetRuntime (  
    [in] LPCWSTR pwzVersion,  
    [in] REFIID riid,  
    [out,iid_is(riid), retval] LPVOID *ppRuntime  
);

Parametry

pwzVersion
[w] Wersja kompilacji .NET Framework przechowywana w metadanych w formacie "vA". B[. X]". A, B i X to liczby dziesiętne, które odpowiadają wersji głównej, wersji pomocniczej i numerowi kompilacji.

Uwaga

Ten parametr musi być zgodny z nazwą katalogu wersji .NET Framework, ponieważ jest wyświetlany w obszarze C:\Windows\Microsoft.NET\Framework lub C:\Windows\Microsoft.NET\Framework64.

Przykładowe wartości to "v1.0.3705", "v1.1.4322", "v2.0.50727" i "v4.0. X", gdzie X zależy od zainstalowanego numeru kompilacji. Wymagany jest prefiks "v".

riid
[w] Identyfikator żądanego interfejsu. Obecnie jedyną prawidłową wartością tego parametru jest IID_ICLRRuntimeInfo.

ppRuntime
[out] Wskaźnik do interfejsu ICLRRuntimeInfo , który odpowiada żądanemu środowisku uruchomieniowemu.

Wartość zwracana

Ta metoda zwraca następujące określone elementy HRESULTs, a także błędy HRESULT wskazujące niepowodzenie metody.

HRESULT Opis
S_OK Metoda została ukończona pomyślnie.
E_POINTER pwzVersion lub ppRuntime ma wartość null.

Uwagi

Ta metoda spójnie współdziała ze starszymi interfejsami, takimi jak interfejs ICorRuntimeHost i starsze funkcje, takie jak przestarzałe funkcje (zobacz Przestarzałe CorBindTo* funkcje hostingu CLR w interfejsie API hostingu .NET Framework 2.0). Oznacza to, że środowiska uruchomieniowe ładowane ze starszym interfejsem API są widoczne dla nowego interfejsu API, a środowiska uruchomieniowe ładowane z nowym interfejsem API są widoczne dla starszego interfejsu API.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MetaHost.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od 4

Zobacz też

  • Last updated on