Aracılığıyla paylaş


ICLRMetaHost::GetRuntime Metodu

Ortak dil çalışma zamanının (CLR) belirli bir sürümüne karşılık gelen ICLRRuntimeInfo arabirimini alır. Bu yöntem, STARTUP_LOADER_SAFEMODE bayrağıyla kullanılan CorBindToRuntimeEx işlevinin yerini alır.

Sözdizimi

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

Parametreler

pwzVersion
[in] Meta verilerde depolanan .NET Framework derleme sürümü, "vA. B[. X]". A, B ve X , ana sürüme, ikincil sürüme ve derleme numarasına karşılık gelen ondalık sayılardır.

Not

Bu parametre, C:\Windows\Microsoft.NET\Framework veya C:\Windows\Microsoft.NET\Framework64 altında göründüğünden, .NET Framework sürümünün dizin adıyla eşleşmelidir.

Örnek değerler şunlardır: "v1.0.3705", "v1.1.4322", "v2.0.50727" ve "v4.0. X", burada X yüklü derleme numarasına bağlıdır. "v" ön eki gereklidir.

riid
[in] İstenen arabirimin tanımlayıcısı. Şu anda bu parametre için tek geçerli değer IID_ICLRRuntimeInfo.

ppRuntime
[out] İstenen çalışma zamanına karşılık gelen ICLRRuntimeInfo arabirimine yönelik bir işaretçi.

Dönüş Değeri

Bu yöntem, aşağıdaki belirli HRESULTs ve yöntem hatasını gösteren HRESULT hatalarını döndürür.

HRESULT Description
S_OK Yöntem başarıyla tamamlandı.
E_POINTER pwzVersion veya ppRuntime null.

Açıklamalar

Bu yöntem, ICorRuntimeHost arabirimi gibi eski arabirimlerle ve kullanım CorBindTo* dışı işlevler gibi eski işlevlerle tutarlı bir şekilde etkileşim kurar (bkz. .NET Framework 2.0 barındırma API'sindeki Kullanım Dışı CLR Barındırma İşlevleri). Yani, eski API ile yüklenen çalışma zamanları yeni API'ye görünür ve yeni API ile yüklenen çalışma zamanları eski API'ye görünür.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MetaHost.h

Kitaplığı: MSCorEE.dll'da kaynak olarak dahil edilen

.NET Framework Sürümleri: 4'ten beri kullanılabilir

Ayrıca bkz.