ICLRDebuggingLibraryProvider3::P rovideWindowsLibrary 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 ProvideWindowsLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Parametreler

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

pwszRuntimeModule
[in] Çalışma zamanı veya tek dosyalı modül yolu.

indexType
[in] Sağlanan dizin bilgisi türü (dwTimestamp/dwSizeOfImage). Bkz. LIBRARY_PROVIDER_INDEX_TYPE sabit listesi.

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.

ppResolvedModulePath
[out] Bu, modül dll'sinin null sonlandırılan yoludur. Windows'ta CoTaskMemAlloc ile ayrılmalıdır. Unix'te malloc ile ayrılmalıdır. Başarısızlık onu dokunulmadan bırakır. Aşağıdaki güvenlik notunu inceleyin!

Dönüş değeri

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

HRESULT	Açıklama
S_OK	Yöntem başarıyla tamamlandı.

Açıklamalar

ProvideWindowsLibrary hata ayıklayıcının mscordbi.dll ve mscordacwks.dllgibi belirli CLR dosyalarında hata ayıklamak için gereken modülleri sağlamasına olanak tanır.

Hata ayıklayıcı, hata ayıklama modülünü bulmak veya temin etmek için kullanılabilir herhangi bir aracı 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ı ProvideWindowsLibrary gerekir.

mscordbi.dll veya mscordacwks.dllgibi zaten yayımlanmış bir kitaplıkta ciddi bir güvenlik sorunu bulunursa dolguya dosyaların kötü sürümlerini tanımak için düzeltme eki uygulanabilir. Dolgu daha sonra dosyaların düzeltme eki eklenmiş 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 yama yapmışsa oluşabilir. Eşleşmeyen sürümler savunmasız kalır.

Gereksinimler

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Üst bilgi: dbgshim.h

Kitaplık: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET Sürümleri: .NET Core 2.1'den itibaren kullanılabilir