ICLRMetaHost::RequestRuntimeLoadedNotification Yöntemi

Ortak dil çalışma zamanı (CLR) sürümü ilk yüklendiğinde ancak henüz başlatılmadığında çağrılacağı garanti edilen bir geri çağırma işlevi sağlar. Bu yöntem LockClrVersion işlevinin yerini alır.

Sözdizimi

HRESULT RequestRuntimeLoadedNotification (  
    [in] RuntimeLoadedCallbackFnPtr pCallbackFunction);  

Parametreler

pCallbackFunction
[in] Yeni bir çalışma zamanı yüklendiğinde çağrılan geri çağırma işlevi.

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	pCallbackFunction null değeridir.

Açıklamalar

Geri arama aşağıdaki şekilde çalışır:

• Geri çağırma yalnızca bir çalışma zamanı ilk kez yüklendiğinde çağrılır.

• Aynı çalışma zamanının yeniden gelen yükleri için geri çağırma çağrılmıyor.

• Yeniden başlatma olmayan çalışma zamanı yükleri için geri çağırma işlevine yapılan çağrılar seri hale getirilir.

Geri çağırma işlevi aşağıdaki prototipe sahiptir:

typedef void (__stdcall *RuntimeLoadedCallbackFnPtr)(  
                     ICLRRuntimeInfo *pRuntimeInfo,  
                     CallbackThreadSetFnPtr pfnCallbackThreadSet,  
                     CallbackThreadUnsetFnPtr pfnCallbackThreadUnset);  

Geri çağırma işlevi prototipleri aşağıdaki gibidir:

• pfnCallbackThreadSet:

  typedef HRESULT (__stdcall *CallbackThreadSetFnPtr)();  
  

• pfnCallbackThreadUnset:

  typedef HRESULT (__stdcall *CallbackThreadUnsetFnPtr)();  
  

Konak başka bir çalışma zamanının yeniden girişli bir şekilde yüklenmesini veya yüklenmesine neden olmak istiyorsa, pfnCallbackThreadSet geri çağırma işlevinde sağlanan ve pfnCallbackThreadUnset parametreleri aşağıdaki şekilde kullanılmalıdır:

• pfnCallbackThreadSet böyle bir yük denenmeden önce çalışma zamanı yüküne neden olabilecek iş parçacığı tarafından çağrılmalıdır.

• pfnCallbackThreadUnset iş parçacığı artık böyle bir çalışma zamanı yüküne neden olmadığında (ve ilk geri çağırmadan dönmeden önce) çağrılmalıdır.

• pfnCallbackThreadSet ve pfnCallbackThreadUnset her ikisi de yeniden başlatmaz.

Not

Konak uygulamaları parametresinin pCallbackFunction kapsamının dışında ve pfnCallbackThreadUnset çağrısı pfnCallbackThreadSet yapılmamalıdı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.

• ICLRMetaHost Arabirimi
• Barındırma