Aracılığıyla paylaş

ICLRDebuggingLibraryProvider::ProvideLibrary Yöntemi

Ortak dil çalışma zamanı (CLR) sürümüne özgü hata ayıklama kitaplıklarının isteğe bağlı olarak bulunmasına ve yüklenmesine izin veren bir kitaplık sağlayıcısı geri çağırma arabirimi alır.

Sözdizimi

HRESULT ProvideLibrary(
     [in] const WCHAR* pwszFileName,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] HMODULE* hModule);

Parametreler

pwszFilename
[in] İstenen modülün adı.

dwTimestamp
[in] PE dosyalarının COFF dosya üst bilgisinde depolanan tarih saat damgası.

dwSizeOfImage
[in] SizeOfImage PE dosyalarının COFF isteğe bağlı dosya üst bilgisinde depolanan alan.

hModule
[out] İstenen modülün tanıtıcısı.

Dönüş Değeri

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

HRESULT Description
S_OK Yöntemi başarıyla tamamlandı.

Özel durumlar

Açıklamalar

ProvideLibrary hata ayıklayıcının mscordbi.dll ve mscordacwks.dll gibi belirli CLR dosyalarında hata ayıklamak için gereken modülleri sağlamasına olanak tanır. Modül tanıtıcılarının ICLRDebugging::CanUnloadNow yöntemine yapılan bir çağrı serbest kalabileceğini belirtene kadar geçerli kalması gerekir. Bu noktada tanıtıcıları serbest bırakma işlemi çağıranın sorumluluğundadır.

Hata ayıklayıcı, hata ayıklama modülünü bulmak veya temin etmek için kullanılabilir herhangi bir araç kullanabilir.

Önemli

Bu özellik, API çağıranın yürütülebilir ve büyük olasılıkla kötü amaçlı kod içeren modüller sağlamasına olanak tanır. Bir güvenlik önlemi olarak, çağıranın kendisini yürütmeye istekli olmadığı herhangi bir kodu dağıtmak için kullanmaması ProvideLibrary gerekir.

mscordbi.dll veya mscordacwks.dll gibi zaten yayımlanmış bir kitaplıkta ciddi bir güvenlik sorunu bulunursa, dosyaların hatalı sürümlerini tanımak için dolguya düzeltme eki uygulanabilir. Dolgu daha sonra dosyaların düzeltme eki uygulamalı sürümleri için istek gönderebilir ve herhangi bir isteğe yanıt olarak sağlanırsa hatalı sürümleri reddedebilir. Bu durum yalnızca kullanıcı dolgunun yeni bir sürümüne düzeltme eki uygulamadıysa oluşabilir. Eşleşmeyen sürümler savunmasız kalır.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorDebug.idl, CorDebug.h

Kitaplığı: CorGuids.lib

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

Ayrıca bkz.

  • Last updated on