Aracılığıyla paylaş

ICLRMetaHost::RequestRuntimeLoadedNotification Yöntemi

  • Makale

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.