Aracılığıyla paylaş

IHostTaskManager::CallNeedsHostHook Yöntemi

Konağın ortak dil çalışma zamanının (CLR) belirtilen çağrıyı yönetilmeyen bir işleve satır içi olarak satır içi olarak verip veremeyeceğini belirtmesini sağlar.

Sözdizimi

HRESULT CallNeedsHostHook (  
    [in]  SIZE_T target,
    [out] BOOL   *pbCallNeedsHostHook  
);

Parametreler

target
[in] Çağrılacak yönetilmeyen işlevin eşlenen taşınabilir yürütülebilir (PE) dosyasındaki adres.

pbCallNeedsHostHook
[out] Konağın çağrının bağlanmasını gerektirip gerektirmediğini belirten boole değerinin işaretçisi.

Dönüş Değeri

HRESULT Description
S_OK CallNeedsHostHook başarıyla döndürüldü.
HOST_E_CLRNOTAVAILABLE CLR bir işleme yüklenmedi veya CLR yönetilen kodu çalıştıramadığı veya çağrıyı başarıyla işleyemediği bir durumda.
HOST_E_TIMEOUT Arama zaman aşımına uğradı.
HOST_E_NOT_OWNER Arayan, kilidin sahibi değil.
HOST_E_ABANDONED Engellenen bir iş parçacığı veya fiber beklerken bir olay iptal edildi.
E_FAIL Bilinmeyen bir yıkıcı hata oluştu. Bir yöntem E_FAIL döndürdüğünde, CLR artık işlem içinde kullanılamaz. Barındırma yöntemlerine yapılan sonraki çağrılar HOST_E_CLRNOTAVAILABLE döndürür.

Açıklamalar

ClR, kod yürütmeyi iyileştirmeye yardımcı olmak için derleme sırasında her platform çağırma çağrısının analizini gerçekleştirerek çağrının inlined olup olmadığını belirler. CallNeedsHostHook konağın yönetilmeyen bir işleve yapılan çağrının kancalı olmasını gerektirerek bu kararı geçersiz kılabilmesini sağlar. Konak bir kanca gerektiriyorsa, çalışma zamanı çağrıyı satır içinde satır içi yapmaz.

Konak genellikle kayan nokta durumunu ayarlaması gereken bir kanca gerektirir veya bir çağrının konağın çalışma zamanının bellek isteklerini veya alınan kilitleri izleyemediği bir duruma girdiği bildirimini aldıktan sonra gerekir. Konak çağrının kancalı olmasını gerektirdiğinde, çalışma zamanı EnterRuntime, LeaveRuntime, ReverseEnterRuntime ve ReverseLeaveRuntime çağrılarını kullanarak yönetilen koda ve yönetilen koddan geçişlerin konağına bildirir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

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

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.

  • Last updated on