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
